CM_Get_Sibling_Ex-Funktion (cfgmgr32.h)

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Get_Sibling .]

Die CM_Get_Sibling_Ex-Funktion ruft ein Gerät ab, instance mit dem nächsten untergeordneten Knoten eines angegebenen Geräteknotens in der Gerätestruktur eines lokalen Computers oder eines Remotecomputers behandelt wird.

Syntax

CMAPI CONFIGRET CM_Get_Sibling_Ex(
  [out]          PDEVINST pdnDevInst,
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parameter

[out] pdnDevInst

Vom Aufrufer bereitgestellter Zeiger auf das Gerät instance auf den untergeordneten Knoten behandeln, den diese Funktion abruft. Der abgerufene Handle ist an den von hMachine angegebenen Computerhandle gebunden.

[in] dnDevInst

Das vom Aufrufer bereitgestellte Gerät instance Handle, das an den von hMachine angegebenen Computerhandle gebunden ist.

[in] ulFlags

Nicht verwendet, muss null sein.

[in, optional] hMachine

Vom Aufrufer bereitgestelltes Computerhandle, an das das vom Aufrufer bereitgestellte Gerät instance Handle gebunden ist.

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

Um alle untergeordneten Elemente eines Geräteknotens in der Gerätestruktur des lokalen Computers aufzulisten, rufen Sie zuerst CM_Get_Child_Ex auf, um ein Handle für den ersten untergeordneten Knoten abzurufen, und rufen Sie dann CM_Get_Sibling_Ex auf, um Handles für die restlichen untergeordneten Knoten abzurufen.

Informationen zur Verwendung von Gerätehandles instance, die an einen lokalen oder Remotecomputer gebunden sind, finden Sie unter CM_Get_Child_Ex.

Die Funktionalität für den Zugriff auf Remotecomputer wurde in Windows 8 und Windows Server 2012 und höheren Betriebssystemen entfernt, sodass Sie nicht auf Remotecomputer zugreifen können, wenn sie unter diesen Windows-Versionen ausgeführt werden.

Anforderungen

Weitere Informationen

CM_Get_Child_Ex

CM_Get_Sibling