GetFileSize
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função obtém o tamanho, em bytes, do arquivo especificado. Uma versão RAPI dessa função existe chamado CeGetFileSize (RAPI).
Syntax
DWORD GetFileSize(
HANDLE hFile,
LPDWORD lpFileSizeHigh
);
Parameters
- hFile
[no] Abrir identificador para o arquivo cujo tamanho é que está sendo retornado. O identificador deve ter sido criado com o GENERIC_READ ou GENERIC_WRITE acessar para o arquivo.
- lpFileSizeHigh
[out] Ponteiro para a variável onde o alto-palavra ordem de tamanho de arquivo é retornado. Este parâmetro pode ser definido como NULL se o aplicativo não exigir o alto-palavra ordem.
Return Value
A baixa-ordem DWORD o arquivo de tamanho indica sucesso. Se lpFileSizeHigh não está definida para NULL, a função coloca o alto-ordem DWORD do tamanho de arquivo para a variável apontada por esse parâmetro. Se lpFileSizeHigh é definido como NULL, 0xFFFFFFFF indica falha. Para informações de erro estendidas get, chamar GetLastError.
Se lpFileSizeHigh não está definida para NULL, 0xFFFFFFFF indica falha, e GetLastError Retorna um valor Other Than NO_ERROR.
Remarks
Se o valor de retorno é 0xFFFFFFFF e lpFileSizeHigh não está definida para NULL, um aplicativo deve chamar GetLastError Para determinar se a função Êxito ou falha. O seguinte exemplo de código demonstra isso:
//
// Case One: calling the function with lpFileSizeHigh == NULL.
// Try to obtain the size of hFile.
dwSize = GetFileSize (hFile, NULL);
// Result on failure.
if (dwSize == 0xFFFFFFFF)
{
// Obtain the error code.
dwError = GetLastError();
// Resolve the failure.
} // End of error handler.
//
// Case Two: calling the function with lpFileSizeHigh != NULL.
// Try to obtain the size of hFile.
dwSizeLow = GetFileSize (hFile, & dwSizeHigh);
// Result on failure.
if (dwSizeLow == 0xFFFFFFFF && (dwError = GetLastError()) != NO_ERROR )
{
// Resolve the failure.
}
// End of error handler.
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 |