SetEndOfFile

지정된 파일의 파일 종단(EOF)의 위치를, 현재의 파일 포인터의 위치에 이동시킵니다.

BOOL SetEndOfFile(
    HANDLE hFile     // 파일 핸들
);

KERNEL32.DLL

인수

hFile: 파일 종단(EOF)의 위치를 이동시키는 파일의 핸들을 지정합니다.이 핸들은 GENERIC_WRITE 액세스를 지정해 작성된 파일 오브젝트의 것이 아니면 안됩니다.

반환값

성공하면 0 이외의 값이 돌아갑니다.

실패하면 0 하지만 돌아갑니다.확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.

해설

이 함수는, 파일 사이즈를 확장시키거나 감소시키거나 하는데 사용할 수 있습니다.파일 사이즈가 확장되었을 경우, 이전의 파일 종단으로부터 새로운 파일 종단까지의 파일의 내용은 정의되고 있지 않습니다.

CreateFileMapping 함수에 의해서 대상 파일의 파일 매핑 오브젝트가 작성되고 있는 경우에는, 우선 UnmapViewOfFile 함수로 모든 뷰를 안 맵 해, CloseHandle 함수로 파일 매핑 오브젝트를 클로우즈 한 다음에 SetEndOfFile 함수를 호출하지 않으면 안됩니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후