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.

Hinweis Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.

 

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek	Cfgmgr32.lib
DLL	Cfgmgr32.dll

Weitere Informationen

CM_Get_Child_Ex

CM_Get_Sibling