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

Статья
08/22/2023

[Начиная с Windows 8 и Windows Server 2012 эта функция устарела. Вместо этого используйте CM_Get_Class_Property_Keys .]

Функция CM_Get_Class_Property_Keys_Ex извлекает массив ключей свойств устройства, представляющих свойства устройства, заданные для класса интерфейса устройства или класса настройки устройства.

Синтаксис

CMAPI CONFIGRET CM_Get_Class_Property_Keys_Ex(
  [in]            LPCGUID    ClassGUID,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Параметры

[in] ClassGUID

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

[out, optional] PropertyKeyArray

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

[in, out] PropertyKeyCount

Размер буфера PropertyKeyArray в единицах типа DEVPROPKEY. Если свойство PropertyKeyArray имеет значение NULL, параметру *PropertyKeyCount необходимо задать нулевое значение. В качестве выходных данных, если PropertyKeyArray недостаточно велик для хранения всех данных ключа свойства, CM_Get_Class_Property_Keys_Ex возвращает количество ключей в *PropertyKeyCount.

[in] ulFlags

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

CM_CLASS_PROPERTY_INSTALLER

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

CM_CLASS_PROPERTY_INTERFACE

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

[in, optional] hMachine

Дескриптор компьютера, предоставленный вызывающим абонентом, полученный при предыдущем вызове CM_Connect_Machine.

Примечание Использование этой функции для доступа к удаленным компьютерам не поддерживается начиная с Windows 8 и Windows Server 2012, так как эта функция была удалена.

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

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

Требования

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

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

CM_Connect_Machine

SetupDiGetClassPropertyKeys

SetupDiGetClassPropertyKeysEx

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