Функция SetupDiGetDeviceInfoListClass (setupapi.h)

Функция SetupDiGetDeviceInfoListClass извлекает GUID для класса установки устройства , связанного с набором сведений об устройстве, если набор имеет связанный класс.

Синтаксис

WINSETUPAPI BOOL SetupDiGetDeviceInfoListClass(
  [in]  HDEVINFO DeviceInfoSet,
  [out] LPGUID   ClassGuid
);

Параметры

[in] DeviceInfoSet

Дескриптор для запроса сведений об устройстве .

[out] ClassGuid

Указатель на переменную типа GUID, которая получает GUID для связанного класса.

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

Функция возвращает значение TRUE в случае успешного выполнения. В противном случае возвращается значение FALSE , а зарегистрированная ошибка может быть получена с помощью вызова Метода GetLastError.

Комментарии

Если указанный набор сведений об устройстве не имеет связанного класса, так как при создании набора с помощью SetupDiCreateDeviceInfoList не был указан GUID класса, функция завершается сбоем. В этом случае вызов GetLastError возвращает ERROR_NO_ASSOCIATED_CLASS.

Если набор сведений об устройстве предназначен для удаленного компьютера, используйте SetupDiGetDeviceInfoListDetail , чтобы получить связанный дескриптор удаленного компьютера и имя компьютера.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	setupapi.h (включая Setupapi.h)
Библиотека	Setupapi.lib
DLL	Setupapi.dll

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

SetupDiCreateDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListDetail