GetFileInformationByHandle

9/8/2008

Essa função recupera informações sobre o arquivo especificado.

Syntax

BOOL GetFileInformationByHandle( 
  HANDLE hFile, 
  LPBY_HANDLE_FILE_INFORMATION lpFileInformation
);

Parameters

• hFile
  [no] Identificador para o arquivo sobre o qual você desejar para obter informações.

  Esse identificador não deve ser um identificador pipe. Essa função não opera com alças pipe.

• lpFileInformation
  [out] Ponteiro para uma estrutura BY_HANDLE_FILE_INFORMATION que recebe o informações do arquivo. A estrutura pode ser usada em chamadas subseqüentes para esta função para referir para as informações sobre o arquivo.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Depending on o subjacente componentes rede a OS e o tipo de servidor ao qual ele está conectado, essa função pode falhar, retornar informações parciais ou completas informações para o arquivo especificado. Em geral, não use esta função, a menos que seu aplicativo é executado em um conjunto limitado de configurações OS.

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
BY_HANDLE_FILE_INFORMATION
GetFileAttributes
FindFirstFile