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

Статья
02/23/2024

Функция CM_Get_DevNode_Status получает состояние экземпляра устройства из узла устройства (devnode) в дереве устройств локального компьютера.

Примечание

В Windows Vista и более поздних версиях унифицированная модель свойств устройства использует ключ свойства DEVPKEY_Device_DevNodeStatus для представления идентификатора экземпляра устройства. Дополнительные сведения см . в разделе Извлечение состояния и кода проблемы для экземпляра устройства.

Синтаксис

CMAPI CONFIGRET CM_Get_DevNode_Status(
  [out] PULONG  pulStatus,
  [out] PULONG  pulProblemNumber,
  [in]  DEVINST dnDevInst,
  [in]  ULONG   ulFlags
);

Параметры

[out] pulStatus

Адрес расположения для получения битовых флагов состояния. Функция может задать любое сочетание DN_ битовых флагов с префиксом, определенных в Cfg.h.

[out] pulProblemNumber

Адрес расположения для получения одного из CM_PROB_ префиксов проблемных значений, определенных в Cfg.h. Используется, только если DN_HAS_PROBLEM задано в pulStatus.

[in] dnDevInst

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

[in] ulFlags

Не используется, должно быть равно нулю.

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

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

Требования

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

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

CM_Get_Child

CM_Get_DevNode_Status_Ex

Share via