функция CM_Get_Class_PropertyW (cfgmgr32.h)

Статья
02/23/2024

Функция CM_Get_Class_Property извлекает свойство устройства, заданное для класса интерфейса устройства или класса настройки устройства.

Синтаксис

CMAPI CONFIGRET CM_Get_Class_PropertyW(
  [in]      LPCGUID          ClassGUID,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags
);

Параметры

[in] ClassGUID

Указатель на GUID, который идентифицирует класс интерфейса устройства или класс настройки устройства , для которого требуется получить свойство устройства, заданное для класса устройства. Сведения об указании типа класса см. в параметре ulFlags .

[in] PropertyKey

Указатель на структуру DEVPROPKEY , представляющую ключ свойства устройства запрошенного свойства класса устройства.

[out] PropertyType

Указатель на переменную типа DEVPROPTYPE, которая получает идентификатор типа property-data-type запрошенного свойства класса устройства, где идентификатор property-data-type представляет собой побитовое ЗНАЧЕНИЕ OR между идентификатором типа base-data-type и модификатор property-data-type, если базовый тип данных изменен.

[out] PropertyBuffer

Указатель на буфер, получающий запрошенное свойство класса устройства. CM_Get_Class_Property извлекает запрошенное значение свойства, только если буфер достаточно велик для хранения всех данных значения свойства. Указатель может иметь значение NULL.

[in, out] PropertyBufferSize

Размер буфера PropertyBuffer (в байтах). Если параметру PropertyBuffer присвоено значение NULL, параметру *PropertyBufferSize необходимо задать нулевое значение. В качестве выходных данных, если буфер недостаточно велик для хранения всех данных значения свойства, CM_Get_Class_Property возвращает размер данных в байтах в *PropertyBufferSize.

[in] ulFlags

Флаги свойств класса:

CM_CLASS_PROPERTY_INSTALLER

ClassGUID указывает класс настройки устройства. Не сочетайте с CM_CLASS_PROPERTY_INTERFACE.

CM_CLASS_PROPERTY_INTERFACE

ClassGUID указывает класс интерфейса устройства. Не сочетайте с CM_CLASS_PROPERTY_INSTALLER.

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

Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с CR_ префиксами, определенных в Cfgmgr32.h.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Microsoft Windows Vista и более поздних версиях Windows.
Целевая платформа	Универсальное
Верхняя часть	cfgmgr32.h (включая Cfgmgr32.h)
Библиотека	Cfgmgr32.lib

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

SetupDiGetClassProperty

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