Поделиться через


Функция 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 (включая Setupapi.h)
Библиотека Setupapi.lib

См. также раздел

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid