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

Продолжает поиск тома, запущенный вызовом функции 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 .

Комментарии

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

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

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

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

Примеры

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

Требования

См. также

FindFirstVolume

FindVolumeClose

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

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