Função GetVolumePathNamesForVolumeNameA (winbase.h)
Recupera uma lista de letras de unidade e caminhos de pasta montados para o volume especificado.
Sintaxe
BOOL GetVolumePathNamesForVolumeNameA(
[in] LPCSTR lpszVolumeName,
[out] LPCH 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 formato "\?\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx}".
[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 será 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 | winbase.h (incluir Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |