Função GetVolumeNameForVolumeMountPointA (winbase.h)
Recupera um caminho GUID de volume para o volume associado ao ponto de montagem de volume especificado (letra da unidade, volume GUID de volume ou pasta montada).
Sintaxe
BOOL GetVolumeNameForVolumeMountPointA(
[in] LPCSTR lpszVolumeMountPoint,
[out] LPSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Parâmetros
[in] lpszVolumeMountPoint
Um ponteiro para uma cadeia de caracteres que contém o caminho de uma pasta montada (por exemplo, "Y:\MountX") ou uma letra de unidade (por exemplo, "X:\"). A cadeia de caracteres deve terminar com uma barra invertida à direita ('').
[out] lpszVolumeName
Um ponteiro para uma cadeia de caracteres que recebe o caminho guid de volume. Esse caminho é do formulário "\?\Volume{GUID}" em que GUID é um GUID que identifica o volume. Se houver mais de um caminho GUID de volume para o volume, somente o primeiro no cache do gerenciador de montagem será retornado.
[in] cchBufferLength
O comprimento do buffer de saída, em TCHARs. Um tamanho razoável para o buffer acomodar o maior caminho guid de volume possível é de 50 caracteres.
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.
Comentários
Use GetVolumeNameForVolumeMountPoint para obter um caminho guid de volume para uso com funções como SetVolumeMountPoint e FindFirstVolumeMountPoint que exigem um caminho GUID de volume como um parâmetro de entrada. Para obter mais informações sobre caminhos guid de volume, consulte Nomeando um volume.
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) | No |
O SMB não dá suporte a funções de gerenciamento de volume.
Os pontos de montagem não são compatíveis com volumes ReFS.
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 (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |