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

Статья
08/23/2023

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

Синтаксис

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

Параметры

[in] lpszVolumeName

Путь GUID тома для тома. Путь GUID тома имеет вид "\\?\Volume{xxxxxxxx-xxxx-xxxx-xxxxxxxxx}\".

[out] lpszVolumePathNames

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

[in] cchBufferLength

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

[out] lpcchReturnLength

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

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

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

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

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

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

Примеры

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

Требования

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

См. также

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

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