Функция FindFirstVolumeA (winbase.h)
Извлекает имя тома на компьютере. FindFirstVolume используется для начала сканирования томов компьютера.
Синтаксис
HANDLE FindFirstVolumeA(
[out] LPSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Параметры
[out] lpszVolumeName
Указатель на буфер, получающий строку, завершающуюся значением NULL, которая указывает путь GUID тома для первого найденного тома.
[in] cchBufferLength
Длина буфера для получения пути GUID тома в TCHAR.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение представляет собой дескриптор поиска, используемый при последующем вызове функций FindNextVolume и FindVolumeClose .
Если функции не удается найти какие-либо тома, возвращается значение INVALID_HANDLE_VALUE код ошибки. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Функция FindFirstVolume открывает дескриптор поиска тома и возвращает сведения о первом томе, найденном на компьютере. После установки дескриптора поиска можно использовать функцию FindNextVolume для поиска других томов. Если дескриптор поиска больше не нужен, закройте его с помощью функции FindVolumeClose .
Не следует предполагать какую-либо корреляцию между порядком томов, возвращаемых этими функциями, и порядком томов, которые находятся на компьютере. В частности, не следует предполагать корреляцию между порядком томов и буквами диска, назначенными BIOS (если таковые есть) или администратором диска.
В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.
| Технология | Поддерживается |
|---|---|
| Протокол 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 |