SetEndOfFile
9/8/2008
Essa função move o final - do - arquivo posição para o arquivo especificado para o atual posição do ponteiro de arquivo. Uma versão RAPI dessa função existe chamado CeSetEndOfFile (RAPI).
Syntax
BOOL SetEndOfFile(
HANDLE hFile
);
Parameters
- hFile
[no] Identificador para o arquivo para que seu final - do - arquivo (EOF) posição movida. O identificador de arquivo deve ter sido criado com acessar GENERIC_WRITE para o arquivo.
Return Value
Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
Não é possível usar essa função com um identificador para um dispositivo nonseeking, such as um dispositivo de comunicação.
Use esta função para truncar ou estender um arquivo. Se o arquivo é estendido, o conteúdo de arquivo entre a posição EOF antiga e a nova posição não estão definidas. Chamar a função SetFilePointer para definir o ponteiro arquivo para a posição desejada antes configuração final do arquivo.
Se você chamado a função CreateFileMapping para criar um arquivo-objeto mapeamento para hFile, você deve primeiro chamar a função UnmapViewOfFile para desmapeamento todos os modos de exibição e chamar a função CloseHandle para fechar o arquivo-objeto mapeamento antes de chamar essa função.
Requirements
Header | winbase.h |
Library | coredll.lib |
Windows Embedded CE | Windows CE 1.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
File I/O Functions
CreateFile
CreateFileMapping
UnmapViewOfFile
SetFilePointer