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

Статья
08/23/2023

Продолжает поиск тома, запущенный вызовом функции FindFirstVolume . FindNextVolume находит один том для каждого вызова.

Синтаксис

BOOL FindNextVolumeW(
  [in]  HANDLE hFindVolume,
  [out] LPWSTR lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

Параметры

[in] hFindVolume

Дескриптор поиска тома, возвращенный предыдущим вызовом функции FindFirstVolume .

[out] lpszVolumeName

Указатель на строку, которая получает найденный путь GUID тома.

[in] cchBufferLength

Длина буфера, получающего путь GUID тома, в TCHAR.

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

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

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

Не следует предполагать какую-либо корреляцию между порядком томов, возвращаемых этими функциями, и порядком томов на компьютере. В частности, не предполагайте какую-либо корреляцию между порядком томов и буквами диска, назначенными BIOS (если таковые есть) или администратором диска.

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

Технология	Поддерживается
Протокол 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

См. также

FindFirstVolume

FindVolumeClose

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

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