Функция FindNextVolumeA (winbase.h)
Продолжает поиск тома, запущенный вызовом функции FindFirstVolume . FindNextVolume находит один том для каждого вызова.
Синтаксис
BOOL FindNextVolumeA(
[in] HANDLE hFindVolume,
[out] LPSTR 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 3.0 | Нет |
| SMB 3.0 Transparent Failover (TFO) | Нет |
| SMB 3.0 с масштабируемыми общими папками (SO) | Нет |
| Файловая система общего тома кластера (CSVFS) | Да |
| Восстанавливаемая файловая система (ReFS) | Да |
SMB не поддерживает функции управления томами.
Примеры
Пример см. в разделе Отображение путей тома.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winbase.h (включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |