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

Weitere Informationen

CM_Get_Child_Ex

CM_Locate_DevNode