Функция SetupDiClassGuidsFromNameA (setupapi.h)
Функция setupDiClassGuidsFromName извлекает идентификаторы GUID, связанные с указанным именем класса. Этот список основан на классах, установленных в настоящее время в системе.
Синтаксис
WINSETUPAPI BOOL SetupDiClassGuidsFromNameA(
[in] PCSTR ClassName,
[out] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize
);
Параметры
[in] ClassName
Имя класса, для которого требуется получить GUID класса.
[out] ClassGuidList
Указатель на массив для получения списка идентификаторов GUID, связанных с указанным именем класса.
[in] ClassGuidListSize
Количество идентификаторов GUID в массиве classGuidList
[out] RequiredSize
Предоставляет указатель на переменную, которая получает число идентификаторов GUID, связанных с именем класса. Если это число больше размера буфера ClassGuidList, число указывает, насколько большой массив должен быть для хранения всех идентификаторов GUID.
Возвращаемое значение
Функция возвращает TRUE, если она выполнена успешно. В противном случае возвращается FALSE и ошибка журнала может быть получена путем вызова GetLastError.
Замечания
Вызовите SetupDiClassGuidsFromNameEx, чтобы получить идентификаторы GUID класса для класса на удаленном компьютере.
Заметка
Заголовок setupapi.h определяет SetupDiClassGuidsFromName как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| целевая платформа | Настольный |
| заголовка | setupapi.h (include Setupapi.h) |
| библиотеки |
Setupapi.lib |