CM_Locate_DevNode_ExA-Funktion (cfgmgr32.h)

  • Artikel

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

Hinweis Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.
 

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

Weitere Informationen

CM_Get_Child_Ex
CM_Locate_DevNode