CM_Get_Parent-Funktion (cfgmgr32.h)
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 |