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


Функция 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