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