Função GetVolumeNameForVolumeMountPointW (fileapi.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 GetVolumeNameForVolumeMountPointW(
  [in]  LPCWSTR lpszVolumeMountPoint,
  [out] LPWSTR  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.

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

Confira também

DeleteVolumeMountPoint

GetVolumePathName

Pastas montadas

SetVolumeMountPoint

Funções de gerenciamento de volumes