Função GetVolumeInformationByHandleW (fileapi.h)

Recupera informações sobre o sistema de arquivos e o volume associados ao arquivo especificado.

Para recuperar o estado de compactação atual de um arquivo ou diretório, use FSCTL_GET_COMPRESSION.

Sintaxe

BOOL GetVolumeInformationByHandleW(
  [in]            HANDLE  hFile,
  [out, optional] LPWSTR  lpVolumeNameBuffer,
  [in]            DWORD   nVolumeNameSize,
  [out, optional] LPDWORD lpVolumeSerialNumber,
  [out, optional] LPDWORD lpMaximumComponentLength,
  [out, optional] LPDWORD lpFileSystemFlags,
  [out, optional] LPWSTR  lpFileSystemNameBuffer,
  [in]            DWORD   nFileSystemNameSize
);

Parâmetros

[in] hFile

Um manipulador para o arquivo.

[out, optional] lpVolumeNameBuffer

Um ponteiro para um buffer que recebe o nome de um volume especificado. O tamanho máximo do buffer é MAX_PATH+1.

[in] nVolumeNameSize

O comprimento de um buffer de nome de volume, em WCHARs. O tamanho máximo do buffer é MAX_PATH+1.

Esse parâmetro será ignorado se o buffer de nome do volume não for fornecido.

[out, optional] lpVolumeSerialNumber

Um ponteiro para uma variável que recebe o número de série do volume.

Esse parâmetro poderá ser NULL se o número de série não for necessário.

Essa função retorna o número de série do volume que o sistema operacional atribui quando um disco rígido é formatado. Para obter programaticamente o número de série do disco rígido que o fabricante atribui, use a propriedade SerialNumberWin32_PhysicalMedia da Instrumentação de Gerenciamento do Windows (WMI).

[out, optional] lpMaximumComponentLength

Um ponteiro para uma variável que recebe o comprimento máximo, em WCHARs, de um componente de nome de arquivo compatível com um sistema de arquivos especificado.

Um componente de nome de arquivo é a parte de um nome de arquivo entre barras invertidas.

O valor armazenado na variável para a qual *lpMaximumComponentLength aponta é usado para indicar que um sistema de arquivos especificado dá suporte a nomes longos. Por exemplo, para um sistema de arquivos FAT que dá suporte a nomes longos, a função armazena o valor 255, em vez do indicador 8.3 anterior. Nomes longos também podem ter suporte em sistemas que usam o sistema de arquivos NTFS.

[out, optional] lpFileSystemFlags

Um ponteiro para uma variável que recebe sinalizadores associados ao sistema de arquivos especificado.

Esse parâmetro pode ser um ou mais dos sinalizadores a seguir. No entanto, FILE_FILE_COMPRESSION e FILE_VOL_IS_COMPRESSED são mutuamente exclusivos.

[out, optional] lpFileSystemNameBuffer

Um ponteiro para um buffer que recebe o nome do sistema de arquivos, por exemplo, o sistema de arquivos FAT ou o sistema de arquivos NTFS. O tamanho do buffer é especificado pelo parâmetro nFileSystemNameSize .

[in] nFileSystemNameSize

O comprimento do buffer de nome do sistema de arquivos, em WCHARs. O tamanho máximo do buffer é MAX_PATH+1.

Esse parâmetro será ignorado se o buffer de nome do sistema de arquivos não for fornecido.

Valor retornado

Se todas as informações solicitadas forem recuperadas, o valor retornado será diferente de zero.

Se nem todas as informações solicitadas forem recuperadas, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

No Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.

O SMB não dá suporte a funções de gerenciamento de volume.

Requisitos

Confira também

Sobre a KTM

Criptografia de Arquivo

GetCompressedFileSize

GetFileAttributes

GetVolumeInformation

SetErrorMode

SetVolumeLabel

Funções de gerenciamento de volumes