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