CM_Get_Parent_Ex-Funktion (cfgmgr32.h)
[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Get_Parent .]
Die CM_Get_Parent_Ex-Funktion ruft ein Gerät instance Handle an den übergeordneten Knoten eines angegebenen Geräteknotens (Devnode) in einer lokalen oder der Gerätestruktur eines Remotecomputers ab.
Syntax
CMAPI CONFIGRET CM_Get_Parent_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 übergeordneten Knoten, den diese Funktion abruft. Das abgerufene Handle ist an das von hMachine angegebene Computerhandle gebunden.
[in] dnDevInst
Vom Aufrufer bereitgestelltes Gerät instance Handle, das an das von hMachine angegebene 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 in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.
Hinweise
Informationen zur Verwendung von Geräte- instance Handles, 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 späteren Betriebssystemen entfernt, sodass Sie nicht auf Remotecomputer zugreifen können, wenn Sie unter diesen Versionen von Windows 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 (include Cfgmgr32.h) |
| Bibliothek | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |