Função GetDiskFreeSpaceExW (fileapi.h)

  • Artigo

Recupera informações sobre a quantidade de espaço disponível em um volume de disco, que é a quantidade total de espaço, a quantidade total de espaço livre e a quantidade total de espaço livre disponível para o usuário associado ao thread de chamada.

Sintaxe

BOOL GetDiskFreeSpaceExW(
  [in, optional]  LPCWSTR         lpDirectoryName,
  [out, optional] PULARGE_INTEGER lpFreeBytesAvailableToCaller,
  [out, optional] PULARGE_INTEGER lpTotalNumberOfBytes,
  [out, optional] PULARGE_INTEGER lpTotalNumberOfFreeBytes
);

Parâmetros

[in, optional] lpDirectoryName

Um diretório no disco.

Se esse parâmetro for NULL, a função usará a raiz do disco atual.

Se esse parâmetro for um nome UNC, ele deverá incluir uma barra invertida à direita, por exemplo, "\\MyServer\MyShare\".

Esse parâmetro não precisa especificar o diretório raiz em um disco. A função aceita qualquer diretório em um disco.

O aplicativo de chamada deve ter direitos de acesso FILE_LIST_DIRECTORY para isso
"samples".

[out, optional] lpFreeBytesAvailableToCaller

Um ponteiro para uma variável que recebe o número total de bytes gratuitos em um disco que estão disponíveis para o usuário associado ao thread de chamada.

Este parâmetro pode ser NULL.

Se cotas por usuário estiverem sendo usadas, esse valor poderá ser menor que o número total de bytes gratuitos em um disco.

[out, optional] lpTotalNumberOfBytes

Um ponteiro para uma variável que recebe o número total de bytes em um disco que estão disponíveis para o usuário associado ao thread de chamada.

Este parâmetro pode ser NULL.

Se cotas por usuário estiverem sendo usadas, esse valor poderá ser menor que o número total de bytes em um disco.

Para determinar o número total de bytes em um disco ou volume, use IOCTL_DISK_GET_LENGTH_INFO.

[out, optional] lpTotalNumberOfFreeBytes

Um ponteiro para uma variável que recebe o número total de bytes gratuitos em um disco.

Este parâmetro pode ser NULL.

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á 0 (zero). Para obter informações de erro estendidas, chame GetLastError.

Comentários

Os valores obtidos por essa função são do tipo ULARGE_INTEGER. Não trunque esses valores para 32 bits.

A função GetDiskFreeSpaceEx retorna zero (0) para lpTotalNumberOfFreeBytes e lpFreeBytesAvailable para todas as solicitações de CD, a menos que o disco seja um CD não escrito em uma unidade CD-RW.

Comportamento simbólico do link – se o caminho apontar para um link simbólico, a operação será executada no destino.

Observação

O cabeçalho fileapi.h define GetDiskFreeSpaceEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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 do gerenciamento de disco

GetDiskFreeSpace

Getmodulehandle