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


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

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

Синтаксис

CMAPI CONFIGRET CM_Get_DevNode_Property_Keys(
  [in]            DEVINST    dnDevInst,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags
);

Параметры

[in] dnDevInst

Дескриптор экземпляра устройства, привязанный к локальному компьютеру.

[out, optional] PropertyKeyArray

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

[in, out] PropertyKeyCount

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

[in] ulFlags

Зарезервировано. Необходимо задать нулевое значение.

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

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

Комментарии

CM_Get_DevNode_Property_Keys является частью единой модели свойств устройства.

Требования

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

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

SetupDiGetDevicePropertyKeys