Voltar à lista
Windows Win32Dispositivos & volumeskernel32.dll

GetDiskFreeSpaceExW

Consulta o espaço livre e total de um disco/volume, com suporte a valores de 64 bits e cotas por usuário.

Descrição

Equivalente aproximado do `statfs`/`statvfs` do Linux.

Header: fileapi.hDLL: kernel32.dll

Assinatura

BOOL GetDiskFreeSpaceExW(
    LPCWSTR lpDirectoryName,
    PULARGE_INTEGER lpFreeBytesAvailableToCaller,
    PULARGE_INTEGER lpTotalNumberOfBytes,
    PULARGE_INTEGER lpTotalNumberOfFreeBytes
);

Parâmetros

ParâmetroTipoDescrição
lpDirectoryNameLPCWSTRCaminho dentro do volume a consultar.
lpFreeBytesAvailableToCallerPULARGE_INTEGERBytes livres disponíveis ao chamador (considerando cotas).
lpTotalNumberOfBytesPULARGE_INTEGERTamanho total do volume.
lpTotalNumberOfFreeBytesPULARGE_INTEGERBytes livres totais no volume.

Valor de retorno

Diferente de zero em sucesso; 0 em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_PATH_NOT_FOUND(3)
O sistema não conseguiu encontrar o caminho especificado.

Relacionadas

Mesma categoria

DefineDosDeviceWDeviceIoControlGetDriveTypeWGetLogicalDrivesGetLogicalDriveStringsWGetVolumeInformationWQueryDosDeviceW