CM_Get_DevNode_Status-Funktion (cfgmgr32.h)

Die CM_Get_DevNode_Status-Funktion ruft die status eines Geräts instance von seinem Geräteknoten (devnode) in der Gerätestruktur des lokalen Computers ab.

Hinweis

In Windows Vista und höher verwendet das einheitliche Geräteeigenschaftenmodell den DEVPKEY_Device_DevNodeStatusEigenschaftenschlüssel, um den Gerätebezeichner instance darzustellen. Ausführliche Informationen finden Sie unter Abrufen des status und Problemcodes für ein Gerät instance.

Syntax

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

Parameter

[out] pulStatus

Adresse eines Speicherorts zum Empfangen status Bitflags. Die Funktion kann eine beliebige Kombination der DN_ präfixierten Bitflags festlegen, die in Cfg.h definiert sind.

[out] pulProblemNumber

Adresse eines Speicherorts, um einen der in Cfg.h definierten CM_PROB_-Präfix-Problemwerte zu empfangen. Wird nur verwendet, wenn DN_HAS_PROBLEM in pulStatus festgelegt ist.

[in] dnDevInst

Das vom Anrufer bereitgestellte Gerät instance Handle, das an den lokalen Computer gebunden ist.

[in] ulFlags

Nicht verwendet, muss null sein.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der CR_-Präfix-Fehlercodes zurückgegeben, die in Cfgmgr32.h definiert sind.

Hinweise

Informationen zur Verwendung von Gerätehandles instance, die an den lokalen Computer gebunden sind, finden Sie unter CM_Get_Child.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform	Universell
Header	cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek	Cfgmgr32.lib; OneCoreUAP.lib auf Windows 10
DLL	CfgMgr32.dll

Weitere Informationen

CM_Get_Child

CM_Get_DevNode_Status_Ex