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

Статья
11/20/2024

Извлекает список букв дисков и подключенных путей к папке для указанного тома.

Синтаксис

BOOL GetVolumePathNamesForVolumeNameW(
  [in]  LPCWSTR lpszVolumeName,
  [out] LPWCH   lpszVolumePathNames,
  [in]  DWORD   cchBufferLength,
  [out] PDWORD  lpcchReturnLength
);

Параметры

[in] lpszVolumeName

Путь идентификатора GUID тома тома. Путь тома имеет форму "\\?\Volume{xxxx-xxxx}\".

[out] lpszVolumePathNames

Указатель на буфер, который получает список букв диска и подключенных путей к папке. Список представляет собой массив строк, завершаемых значением NULL, завершаемым дополнительным символом NULL. Если буфер недостаточно велик, чтобы сохранить полный список, буфер содержит столько списка, сколько это возможно.

[in] cchBufferLength

Длина буфера lpszVolumePathNames в WCHARs, включая все символы NULL.

[out] lpcchReturnLength

Если вызов выполнен успешно, этот параметр — это число WCHARs скопировано в буфер lpszVolumePathNames. В противном случае этот параметр представляет собой размер буфера, необходимого для хранения полного списка, в WCHARs.

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

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

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError. Если буфер недостаточно велик для хранения полного списка, код ошибки ERROR_MORE_DATA, а параметр lpcchReturnLeng th получает необходимый размер буфера.

Замечания

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

Технологии	Поддержанный
Протокол SMB 3.0	Нет
Отработка отказа SMB 3.0 (TFO)	Нет
SMB 3.0 с масштабируемыми общими папками (SO)	Нет
Файловая система общего тома кластера (CSVFS)	Да
Отказоустойчивая файловая система (ReFS)	Да

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

Примеры

Пример см. в разделе Отображение путей тома.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	fileapi.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

подключенных папок

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

Поделиться через