CM_Locate_DevNode_ExA-Funktion (cfgmgr32.h)
[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Locate_DevNode .]
Die CM_Locate_DevNode_Ex-Funktion ruft ein Gerät ab, instance dem Geräteknoten zugeordnet ist, der einem angegebenen Gerät instance-ID auf einem lokalen Computer oder einem Remotecomputer zugeordnet ist.
Syntax
CMAPI CONFIGRET CM_Locate_DevNode_ExA(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_A pDeviceID,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parameter
[out] pdnDevInst
[in, optional] pDeviceID
[in] ulFlags
Eine Variable vom ULONG-Typ, die einen der folgenden Flagwerte bereitstellt, die gelten, wenn der Aufrufer ein Gerät instance Bezeichner bereitstellt:
CM_LOCATE_DEVNODE_NORMAL
Die Funktion ruft das Gerät instance Handle für das angegebene Gerät nur ab, wenn das Gerät derzeit in der Gerätestruktur konfiguriert ist.
CM_LOCATE_DEVNODE_PHANTOM
Die Funktion ruft ein Gerät instance Handle für das angegebene Gerät ab, wenn das Gerät derzeit in der Gerätestruktur konfiguriert ist oder das Gerät ein nicht vorhandenes Gerät ist, das derzeit nicht in der Gerätestruktur konfiguriert ist.
CM_LOCATE_DEVNODE_CANCELREMOVE
Die Funktion ruft ein Gerät instance Handle für das angegebene Gerät ab, wenn das Gerät derzeit in der Gerätestruktur konfiguriert ist oder gerade für die Gerätestruktur entfernt wird. Wenn das Gerät gerade entfernt wird, bricht die Funktion das Entfernen des Geräts ab.
CM_LOCATE_DEVNODE_NOVALIDATION
Wird nicht verwendet.
[in, optional] hMachine
Ein Computerhandle, das aus einem Aufruf von CM_Connect_Machine abgerufen wurde, oder ein Computerhandle, an das ein Geräteinformationssatz gebunden ist. Der Computerhandle für einen Geräteinformationssatz wird aus dem RemoteMachineHandle-Member der SP_DEVINFO_LIST_DETAIL_DATA Struktur für den Geräteinformationssatz abgerufen. Rufen Sie SetupDiGetDeviceInfoListDetail auf, um eine SP_DEVINFO_LIST_DETAIL_DATA-Struktur zu erhalten.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt CM_Locate_DevNode CR_SUCCESS zurück. Andernfalls gibt die Funktion einen der CR_-Präfix-Fehlercodes zurück, die in Cfgmgr32.h definiert sind.
Hinweise
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 |