Freigeben über


CM_Get_Child_Ex-Funktion (cfgmgr32.h)

[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.

Sie können auch die Geräteinstallationsfunktionen verwenden, um Gerätehandles instance abzurufen. Führen Sie die folgenden Schritte aus:
  1. Rufen Sie einen Geräteinformationssatz ab.
  2. Rufen Sie eine SP_DEVINFO_DATA-Struktur für ein Gerät ab, das im Geräteinformationssatz instance.
  3. Rufen Sie das Gerät instance Handle für das Gerät instance aus dem DevInst-Element der SP_DEVINFO_DATA-Struktur ab.
  4. 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

Weitere Informationen

CM_Get_Child

CM_Get_Parent

CM_Get_Parent_Ex

CM_Get_Sibling

CM_Get_Sibling_Ex

CM_Locate_DevNode

CM_Locate_DevNode_Ex

SP_DEVINFO_DATA

SP_DEVINFO_LIST_DETAIL_DATA

SetupDiGetDeviceInfoListDetail