CM_Get_Parent-Funktion (cfgmgr32.h)

  • Artikel

Die CM_Get_Parent-Funktion ruft ein Gerät instance Handle an den übergeordneten Knoten eines angegebenen Geräteknotens (devnode) in der Gerätestruktur des lokalen Computers ab.

Hinweis

In Windows Vista und höheren Versionen von Windows verwendet das einheitliche Geräteeigenschaftenmodell den DEVPKEY_Device_ParentEigenschaftenschlüssel , um das übergeordnete Gerät darzustellen. Weitere Informationen finden Sie unter Abrufen von Gerätebeziehungen .

Syntax

CMAPI CONFIGRET CM_Get_Parent(
  [out] PDEVINST pdnDevInst,
  [in]  DEVINST  dnDevInst,
  [in]  ULONG    ulFlags
);

Parameter

[out] pdnDevInst

Vom Aufrufer bereitgestellter Zeiger auf das Gerät instance Handle auf den übergeordneten Knoten, den diese Funktion abruft. Das abgerufene Handle ist an den lokalen Computer gebunden.

[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 eines Gerätes instance Handle, das an den lokalen Computer gebunden ist, finden Sie unter CM_Get_Child.

Anforderungen

   
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_Parent_Ex