Функция SetEndOfFile перемещает позицию метки конца файла (EOF) для заданного файла к текущую позицию его указателя.
Эта функция устанавливает физический конец файла (как указывается распределенными кластерами). Чтобы установить логический конец файла, используйте функцию SetFileValidData.
Синтаксис
BOOL SetEndOfFile( HANDLE hFile // дескриптор файла ); |
Параметры
hFile
[in] Дескриптор файла, позиция EOF которого перемещается. Дескриптор файла, должен быть, создан с правом доступа GENERIC_WRITE. Для получения дополнительной информации, см. статью Защита файла и права доступа.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение не нуль.
Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Эта функция может использоваться для того, чтобы сократить или удлинить файл. Если файл удлиняется, содержание файла между старой позицией EOF и новой позицией не определяется.
Если Вы вызвали функцию CreateFileMapping, чтобы создать объект отображения файла в памяти для параметра hFile, Вы должны сначала вызвать функцию UnmapViewOfFile, чтобы прекратить проецирование всех отображений и вызвать функцию CloseHandle, чтобы закрыть объект отображения файла в память прежде, чем Вы сможете вызвать SetEndOfFile.
Смотри также
Обзор Управление файлами, Функции для файлового ввода-вывода (I/O), CloseHandle, CreateFile, CreateFileMapping, SetFileValidData, UnmapViewOfFile
Размещение и совместимость SetEndOfFile |
||
К |
Windows XP |
Да |
л |
Windows 2000 Professional |
Да |
и |
Windows NT Workstation |
Да |
е |
Windows Me |
Да |
н |
Windows 98 |
Да |
т |
Windows 95 |
Да |
С |
Windows Server 2003 |
Да |
е | Windows 2000 Server | Да |
р | Windows NT Server | Да |
в | ||
е | ||
р | ||
Используемая библиотека |
Kernel32.lib |
|
Используемая DLL | - | |
Заголовочный файл | ||
- объявлено в |
Winbase.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |