Функция 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

См. также

FindNextVolume

FindVolumeClose

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

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