Функция GetVolumePathNamesForVolumeNameA (winbase.h)

Статья
03/03/2024

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

Синтаксис

BOOL GetVolumePathNamesForVolumeNameA(
  [in]  LPCSTR lpszVolumeName,
  [out] LPCH   lpszVolumePathNames,
  [in]  DWORD  cchBufferLength,
  [out] PDWORD lpcchReturnLength
);

Параметры

[in] lpszVolumeName

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

[out] lpszVolumePathNames

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

[in] cchBufferLength

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

[out] lpcchReturnLength

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

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

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

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

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

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

Примеры

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

Требования

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

См. также

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

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