Função GetVolumeNameForVolumeMountPointA (winbase.h)

  • Artigo

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

Confira também

DeleteVolumeMountPoint

GetVolumePathName

Pastas montadas

SetVolumeMountPoint

Funções de gerenciamento de volumes