Função GetVolumePathNamesForVolumeNameW (fileapi.h)

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{xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxxx}\".

[out] lpszVolumePathNames

Um ponteiro para um buffer que recebe a lista de letras de unidade e caminhos de pasta montados. A lista é uma matriz de cadeias de caracteres terminadas em nulo encerradas por um caractere de 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 WCHARs, incluindo todos os caracteres NULL .

[out] lpcchReturnLength

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

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será 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.

Observações

No Windows 8 e no 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.

Exemplos

Para obter um exemplo, consulte Exibindo caminhos de volume.

Requisitos

Consulte também

pastas montadas

Funções de gerenciamento de volume