CM_Get_Sibling-Funktion (cfgmgr32.h)

  • Artikel

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

Weitere Informationen

CM_Get_Child

CM_Get_Sibling_Ex