Função GetDiskSpaceInformationA (fileapi.h)

Obtém informações de espaço em disco para um volume em um determinado caminho raiz.

Sintaxe

HRESULT GetDiskSpaceInformationA(
  LPCSTR                 rootPath,
  DISK_SPACE_INFORMATION *diskSpaceInfo
);

Parâmetros

rootPath

Um ponteiro para uma cadeia de caracteres que contém o diretório raiz do volume a ser consultado.

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

diskSpaceInfo

Uma estrutura DISK_SPACE_INFORMATION que contém informações sobre o espaço em disco atual para o volume no caminho raiz fornecido.

Valor de retorno

Retorna S_OK se a função for bem-sucedida ou um valor de Valores HRESULT Comuns se falhar. Você pode chamar GetLastError para obter informações de erro estendidas.

Observações

O rootPath deve ser um caminho raiz, como C:\ ou D:\, e não um subdiretório de um caminho raiz.

Requisitos

Requisito	Valor
Cliente mínimo suportado	Windows 10 Build 17763 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível	Windows 10 Server 2019 [aplicativos da área de trabalho | Aplicativos UWP]
cabeçalho	fileapi.h (inclua Windows.h)
Biblioteca	kernel32.lib
de DLL	kernel32.dll

Consulte também

GetDiskSpaceInformationW

DISK_SPACE_INFORMATION