This function moves the end-of-file position for the specified file to the current position of the file pointer. A remote application interface (RAPI) version of this function exists, and it is called CeSetEndOfFile.
At a Glance
| Header file: | Winbase.h |
| Windows CE versions: | 1.0 and later |
Syntax
BOOL SetEndOfFile( HANDLE hFile );
Parameters
hFile
[in] Handle to the file to have its EOF position moved. The file handle must have been created with GENERIC_WRITE access to the file.
Return Values
Nonzero indicates success. Zero indicates failure. 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