Поддерживается на Windows Vista / XP / 2000Pro

Функция FindFirstVolume возвращает имя раздела на компьютере. FindFirstVolume используется для начала сканирования разделов на компьютере.

HANDLE FindFirstVolume(
  LPTSTR lpszVolumeName,
  DWORD cchBufferLength
);

Параметры:

lpszVolumeName	Адрес буфера, который получает нульзаканчивающую строку с уникальным именем раздела первого найденого раздела.
cchBufferLength	Размер буфера в TCHAR.

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

Если функция успешна, возвращаемое значение – это дескриптор, использующийся в последовательных вызовах функций FindNextVolume и FindVolumeClose.

Если функция не находит разделов, то она возвращает ошибку INVALID_HANDLE_VALUE. Для получения дополнительной информации об ошибке, вызывайте GetLastError.

Замечания:

Функция FindFirstVolume открывает дескриптор поиска раздела и возвращает информацию о первом найденом разделе компьютера. После получение дескриптора поиска, вы можете воспользоваться функцией FindNextVolume для поиска следующих разделов. Если дескриптор больше не нужен, закройте его с помощью функции FindVolumeClose.

Для компиляции приложения, которое использует эту функцию, объявите макрос _WIN32_WINNT со значением 0x0500 или больше.

Смотрите также: