CM_Get_Child_Ex-Funktion (cfgmgr32.h)

Artikel
02/26/2024

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

Die CM_Get_Child_Ex-Funktion wird verwendet, um ein Gerät abzurufen, instance zum ersten untergeordneten Knoten eines angegebenen Geräteknotens (devnode) in der Gerätestruktur eines lokalen Computers oder eines Remotecomputers verarbeitet wird.

Syntax

CMAPI CONFIGRET CM_Get_Child_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 handle auf den untergeordneten Knoten, den diese Funktion abruft. Der abgerufene Handle ist an den von hMachine bereitgestellten Maschinenhandle gebunden. Weitere Informationen finden Sie im Abschnitt Hinweise .

[in] dnDevInst

Das vom Anrufer bereitgestellte Gerät instance Handle, das an den von hMachine bereitgestellten Maschinenhandle 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 Devnodes in der Gerätestruktur eines lokalen Computers oder der Gerätestruktur eines Remotecomputers aufzulisten, rufen Sie zuerst CM_Get_Child_Ex auf, um ein Handle für den ersten untergeordneten Knoten zu erhalten, und rufen Sie dann CM_Get_Sibling_Ex auf, um Handles für die restlichen untergeordneten Knoten abzurufen.

Verwenden von Geräteinstanzhandles

Geräte-instance-Handle, die Sie mit PnP-Konfigurations-Manager-Funktionen verwenden, sind wie folgt an Computerhandles gebunden:

Alle instance Handles für lokale Geräte sind an ein LOKALES NULL-Wert-Handle gebunden.
Wenn Sie ein Remotecomputerhandle verwenden, um ein Gerät instance Handle abzurufen, wird das resultierende Remotegerät instance Handle an den Remotecomputerhandle gebunden.
Ein Gerät instance Handle kann nur mit dem Computerhandle verwendet werden, an den es gebunden ist.
Ein Gerät instance Handle kann nur mit einem anderen Gerät instance Handle verwendet werden, wenn beide Geräte- instance Handles an denselben Computerhandle gebunden sind.

Verwenden Sie CM_Connect_Machine, um ein Remotecomputerhandle für die Verwendung mit Remotegerätehandles instance abzurufen.

Führen Sie einen der folgenden Schritte aus, um ein lokales Gerät oder ein Remotegerät instance Handle abzurufen.

Verwenden Sie eine der folgenden Funktionen, um ein An den lokalen Computer gebundenes Gerät instance Handle abzurufen: CM_Locate_DevNode, CM_Get_Child, CM_Get_Parent oder CM_Get_Sibling.
Verwenden Sie eine der folgenden Funktionen, um ein Gerät abzurufen, instance das an einen lokalen computer oder einen Remotecomputer gebunden ist: CM_Locate_DevNode_Ex, CM_Get_Child_Ex, CM_Get_Parent_Ex oder CM_Get_Sibling_Ex.

Sie können auch die Geräteinstallationsfunktionen verwenden, um Gerätehandles instance abzurufen. Führen Sie die folgenden Schritte aus:

Rufen Sie einen Geräteinformationssatz ab.
Rufen Sie eine SP_DEVINFO_DATA-Struktur für ein Gerät ab, das im Geräteinformationssatz instance.
Rufen Sie das Gerät instance Handle für das Gerät instance aus dem DevInst-Element der SP_DEVINFO_DATA-Struktur ab.
Rufen Sie das Computerhandle ab, an das das Gerät instance Handle gebunden ist. Ein Gerät instance Handle, das aus einem Geräteinformationssatz abgerufen wird, ist an den Computerhandle gebunden, an den der Geräteinformationssatz gebunden ist. Sie erhalten den Computerhandle für einen Geräteinformationssatz aus dem RemoteMachineHandle-Member der SP_DEVINFO_LIST_DETAIL_DATA-Struktur . (Rufen Sie SetupDiGetDeviceInfoListDetail auf, um eine SP_DEVINFO_LIST_DETAIL_DATA-Struktur zu erhalten.)

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