Voltar à lista
Windows Win32Dispositivos & volumeskernel32.dll

GetVolumeInformationW

Consulta informações sobre um volume: rótulo, número de série, sistema de arquivos, comprimento máximo de nome.

Descrição

Combina informações que no Linux viriam de `statfs`/`statvfs` com metadados específicos do volume (rótulo, número de série) sem equivalente direto único.

Header: fileapi.hDLL: kernel32.dll

Assinatura

BOOL GetVolumeInformationW(
    LPCWSTR lpRootPathName,
    LPWSTR lpVolumeNameBuffer,
    DWORD nVolumeNameSize,
    LPDWORD lpVolumeSerialNumber,
    LPDWORD lpMaximumComponentLength,
    LPDWORD lpFileSystemFlags,
    LPWSTR lpFileSystemNameBuffer,
    DWORD nFileSystemNameSize
);

Parâmetros

ParâmetroTipoDescrição
lpRootPathNameLPCWSTRCaminho raiz do volume.
lpVolumeNameBufferLPWSTRRecebe o rótulo do volume.
nVolumeNameSizeDWORDTamanho de `lpVolumeNameBuffer`.
lpVolumeSerialNumberLPDWORDSe não for NULL, recebe o número de série do volume.
lpMaximumComponentLengthLPDWORDSe não for NULL, recebe o comprimento máximo de um componente de nome de arquivo.
lpFileSystemFlagsLPDWORDSe não for NULL, recebe as flags de capacidades do sistema de arquivos.
lpFileSystemNameBufferLPWSTRRecebe o nome do sistema de arquivos, ex.: "NTFS".
nFileSystemNameSizeDWORDTamanho de `lpFileSystemNameBuffer`.

Valor de retorno

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

Códigos de erro (GetLastError)

ERROR_NOT_READY(21)
O dispositivo não está pronto.
ERROR_PATH_NOT_FOUND(3)
O sistema não conseguiu encontrar o caminho especificado.

Relacionadas

Mesma categoria

DefineDosDeviceWDeviceIoControlGetDiskFreeSpaceExWGetDriveTypeWGetLogicalDrivesGetLogicalDriveStringsWQueryDosDeviceW