Функция GetVolumeNameForVolumeMountPointW (fileapi.h)

Извлекает путь GUID тома для тома, связанного с указанной точкой подключения тома (буква диска, путь GUID тома или подключенная папка).

Синтаксис

BOOL GetVolumeNameForVolumeMountPointW(
  [in]  LPCWSTR lpszVolumeMountPoint,
  [out] LPWSTR  lpszVolumeName,
  [in]  DWORD   cchBufferLength
);

Параметры

[in] lpszVolumeMountPoint

Указатель на строку, содержащую путь к подключенной папке (например, "Y:\MountX\") или букву диска (например, "X:\"). Строка должна заканчиваться обратной косой чертой ('\').

[out] lpszVolumeName

Указатель на строку, получающую путь GUID тома. Этот путь имеет форму "\?\Volume{GUID}\", где GUID — это GUID , идентифицирующий том. Если для тома имеется несколько путей GUID тома, возвращается только первый из них в кэше диспетчера подключений.

[in] cchBufferLength

Длина выходного буфера в TCHAR. Допустимый размер буфера для размещения максимально возможного пути GUID тома составляет 50 символов.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Используйте GetVolumeNameForVolumeMountPoint , чтобы получить путь GUID тома для использования с такими функциями, как SetVolumeMountPoint и FindFirstVolumeMountPoint , для которых в качестве входного параметра требуется путь GUID тома. Дополнительные сведения о путях GUID тома см. в разделе Именование тома.

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

SMB не поддерживает функции управления томами.

Точки подключения не поддерживаются томами ReFS.

Требования

См. также

DeleteVolumeMountPoint

GetVolumePathName

Подключенные папки

SetVolumeMountPoint

Функции управления томами