Функция SetupDiGetINFClassW (setupapi.h)
Функция setupDiGetINFClass возвращает класс указанного INF-файла устройства.
Синтаксис
WINSETUPAPI BOOL SetupDiGetINFClassW(
[in] PCWSTR InfName,
[out] LPGUID ClassGuid,
[out] PWSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Параметры
[in] InfName
Указатель на строку, завершающую значение NULL, которая предоставляет имя INF-файла устройства. Это имя может включать путь. Однако если указано только имя файла, файл выполняется поиск в каждом каталоге, который указан в записи DevicePath DevicePath в разделе HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion подраздела реестра. Максимальная длина в символах, включая конечный элемент NULL, имени inf-файла, завершаемого null, MAX_PATH.
[out] ClassGuid
Указатель на переменную GUID типа, которая получает GUID класса для указанного INF-файла. Если INF-файл не указывает имя класса, функция возвращает GUID_NULL структуру. Вызовите SetupDiClassGuidsFromName, чтобы определить, установлен ли один или несколько классов с этим именем.
[out] ClassName
Указатель на буфер, получающий строку, завершающую значение NULL, которая содержит имя класса для указанного INF-файла. Если INF-файл не указывает имя класса, но указывает GUID, этот буфер получает имя, полученное путем вызова SetupDiClassNameFromGuid. Однако если SetupDiClassNameFromGuid не удается получить имя класса (например, класс не установлен), он возвращает пустую строку.
[in] ClassNameSize
Размер буфера в символах, на который указывает параметр ClassName. Максимальная длина имени класса, завершаемого значением NULL, в символах, MAX_CLASS_NAME_LEN.
[out, optional] RequiredSize
Указатель на переменную типа DWORD, которая получает количество символов, необходимых для хранения имени класса, включая завершение NULL. Этот указатель необязателен и может быть null.
Возвращаемое значение
Функция возвращает TRUE, если она выполнена успешно. В противном случае возвращается FALSE, а ошибка журнала может быть получена с помощью вызова GetLastError.
Замечания
Не используйте эту функцию с INF-файлами для Windows 9x или Millennium Edition.
Заметка
Заголовок setupapi.h определяет SetupDiGetINFClass как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| целевая платформа | Настольный |
| заголовка | setupapi.h (include Setupapi.h) |
| библиотеки |
Setupapi.lib |
| набор API | ext-ms-win-setupapi-classinstallers-l1-1-2 (представлено в Windows 10 версии 10.0.14393) |