Função GetVolumePathNamesForVolumeNameW (fileapi.h)

  • Artigo

Recupera uma lista de letras de unidade e caminhos de pasta montados para o volume especificado.

Sintaxe

BOOL GetVolumePathNamesForVolumeNameW(
  [in]  LPCWSTR lpszVolumeName,
  [out] LPWCH   lpszVolumePathNames,
  [in]  DWORD   cchBufferLength,
  [out] PDWORD  lpcchReturnLength
);

Parâmetros

[in] lpszVolumeName

Um caminho GUID de volume para o volume. Um caminho GUID de volume é do formulário "\\?\Volume{xxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxx}\".

[out] lpszVolumePathNames

Um ponteiro para um buffer que recebe a lista de letras da unidade e caminhos de pasta montados. A lista é uma matriz de cadeias de caracteres terminadas em nulo encerradas por um caractere NULL adicional. Se o buffer não for grande o suficiente para manter a lista completa, o buffer conterá o máximo possível da lista.

[in] cchBufferLength

O comprimento do buffer lpszVolumePathNames , em TCHARs, incluindo todos os caracteres NULL .

[out] lpcchReturnLength

Se a chamada for bem-sucedida, esse parâmetro será o número de TCHARs copiados para o buffer lpszVolumePathNames . Caso contrário, esse parâmetro é o tamanho do buffer necessário para manter a lista completa, em TCHARs.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Se o buffer não for grande o suficiente para manter a lista completa, o código de erro será ERROR_MORE_DATA e o parâmetro lpcchReturnLength receberá o tamanho do buffer necessário.

Comentários

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

Tecnologia Com suporte
Protocolo SMB (SMB) 3.0 No
TFO (Failover transparente) do SMB 3.0 No
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) No
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) Sim
ReFS (Sistema de Arquivos Resiliente) Sim
 

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

Exemplos

Para obter um exemplo, consulte Exibindo caminhos de volume.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho fileapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Pastas montadas

Funções de gerenciamento de volumes