CM_Get_Sibling-Funktion (cfgmgr32.h)
Die CM_Get_Sibling-Funktion ruft ein Gerät instance Handle an den nächsten gleichgeordneten 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_SiblingsEigenschaftenschlüssel , um gleichgeordnete Geräte darzustellen. Weitere Informationen finden Sie unter Abrufen von Gerätebeziehungen .
Syntax
CMAPI CONFIGRET CM_Get_Sibling(
[out] PDEVINST pdnDevInst,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Parameter
[out] pdnDevInst
Vom Aufrufer bereitgestellter Zeiger auf das Gerät instance Handle auf den gleichgeordneten Knoten, den diese Funktion abruft. Das abgerufene Handle ist an den lokalen Computer gebunden.
[in] dnDevInst
Vom Aufrufer bereitgestelltes 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 in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.
Hinweise
Um alle untergeordneten Elemente eines Devnodes in der Gerätestruktur des lokalen Computers aufzulisten, rufen Sie zunächst CM_Get_Child auf, um ein Handle für den ersten untergeordneten Knoten zu erhalten, und rufen Sie dann CM_Get_Sibling auf, um Handles für die restlichen untergeordneten Knoten abzurufen.
Informationen zur Verwendung von Geräte- instance Handles, 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 (include Cfgmgr32.h) |
| Bibliothek | Cfgmgr32.lib; OneCoreUAP.lib auf Windows 10 |
| DLL | CfgMgr32.dll |