Função GetFileSizeEx (fileapi.h)

Recupera o tamanho do arquivo especificado.

Sintaxe

BOOL GetFileSizeEx(
  [in]  HANDLE         hFile,
  [out] PLARGE_INTEGER lpFileSize
);

Parâmetros

[in] hFile

Um manipulador para o arquivo. O identificador deve ter sido criado com o acesso FILE_READ_ATTRIBUTES direito ou equivalente, ou o chamador deve ter permissão suficiente no diretório que contém o arquivo. Para obter mais informações, consulte Segurança de arquivos e Direitos de Acesso.

[out] lpFileSize

Um ponteiro para uma estrutura LARGE_INTEGER que recebe o tamanho do arquivo, em bytes.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Operações transacionadas: Se houver uma transação associada ao identificador de arquivo, a função retornará informações para a exibição de arquivo isolado.

Aplicativos da Windows Store: Não há suporte para GetFileSizeEx. Use GetFileInformationByHandleEx.

No Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.

Tecnologia	Com suporte
Protocolo SMB (SMB) 3.0	Sim
TFO (Failover transparente) do SMB 3.0	Sim
SMB 3.0 com compartilhamentos de arquivos de expansão (SO)	Sim
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS)	Sim
ReFS (Sistema de Arquivos Resiliente)	Sim

Requisitos

Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	fileapi.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll

Confira também

Funções de gerenciamento de arquivos

LARGE_INTEGER