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 |