CM_Locate_DevNode_ExW-Funktion (cfgmgr32.h)
[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Locate_DevNode .]
Die funktion CM_Locate_DevNode_Ex ruft ein Gerät instance Handle an den Geräteknoten ab, der einem angegebenen Gerät instance-ID auf einem lokalen Computer oder einem Remotecomputer zugeordnet ist.
Syntax
CMAPI CONFIGRET CM_Locate_DevNode_ExW(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_W pDeviceID,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parameter
[out] pdnDevInst
Ein Zeiger auf das Gerät instance Handle, das diese Funktion abruft. Das abgerufene Handle ist an das von hMachine angegebene Computerhandle gebunden.
[in, optional] pDeviceID
Ein Zeiger auf eine NULL-endende Zeichenfolge, die ein Gerät instance-ID darstellt. Wenn dieser Wert NULL ist oder auf eine Zeichenfolge der Länge Null zeigt, stellt die Funktion ein Gerät instance Handle an das Gerät am Stamm der Gerätestruktur bereit.
[in] ulFlags
Eine Variable des ULONG-Typs, 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 von einem Aufruf an CM_Connect_Machine abgerufen wurde, oder ein Computerhandle, an das ein Geräteinformationssatz gebunden ist. Das 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ä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 Den Betriebssystemen Windows 8 und Windows Server 2012 und höher entfernt, sodass Sie nicht auf Remotecomputer zugreifen können, wenn sie unter diesen Versionen von Windows ausgeführt werden.
Anforderungen
| 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 |