Функция 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 3.0 Нет
Прозрачная отработка отказа (TFO) SMB 3.0 Нет
SMB 3.0 с масштабируемыми общими папками (SO) Нет
Файловая система общего тома кластера (CSVFS) Да
Восстанавливаемая файловая система (ReFS) Нет
 

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

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

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header fileapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

DeleteVolumeMountPoint

GetVolumePathName

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

SetVolumeMountPoint

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