SetEndOfFile
The SetEndOfFile
function moves the end-of-file (EOF) position for the specified file to the
current position of the file pointer.
BOOL SetEndOfFile(
|
HANDLE hFile |
// handle of file
whose EOF is to be set |
|
); |
|
Parameters
hFile
Identifies
the file to have its EOF position moved. The file handle must have been created
with GENERIC_WRITE access to the file.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
This function
can be used to truncate or extend a file. If the file is extended, the contents
of the file between the old EOF position and the new position are not defined.
If you called
CreateFileMapping to create a file-mapping object for hFile, you
must first call UnmapViewOfFile to unmap all views and call CloseHandle
to close the file-mapping object before you can call SetEndOfFile.
See Also