Função GetDiskSpaceInformationA (fileapi.h)

  • Artigo

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.

Retornar valor

Retorna TRUE se a função for bem-sucedida ou FALSE se falhar. Para obter outras informações sobre o erro, chame a função GetLastError.

Comentários

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 com suporte Windows 10 Build 17763 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 10 Server 2019 [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho fileapi.h (inclua Windows.h)
Biblioteca kernel32.lib
DLL kernel32.dll

Confira também

GetDiskSpaceInformationW

DISK_SPACE_INFORMATION