Функция SetupDiGetINFClassA (setupapi.h)
Функция SetupDiGetINFClass возвращает класс указанного INF-файла устройства.
Синтаксис
WINSETUPAPI BOOL SetupDiGetINFClassA(
[in] PCSTR InfName,
[out] LPGUID ClassGuid,
[out] PSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Параметры
[in] InfName
Указатель на строку с завершением NULL, которая предоставляет имя INF-файла устройства. Это имя может включать путь. Однако если указано только имя файла, поиск файла выполняется в каждом каталоге, который указан в записи 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | setupapi.h (включая Setupapi.h) |
| Библиотека | Setupapi.lib |