CM_Locate_DevNodeW-Funktion (cfgmgr32.h)

  • Artikel

Die CM_Locate_DevNode-Funktion ruft ein Gerät instance Handle für den Geräteknoten ab, der einem angegebenen Gerät instance-ID auf dem lokalen Computer zugeordnet ist.

Syntax

CMAPI CONFIGRET CM_Locate_DevNodeW(
  [out]          PDEVINST    pdnDevInst,
  [in, optional] DEVINSTID_W pDeviceID,
  [in]           ULONG       ulFlags
);

Parameter

[out] pdnDevInst

Ein Zeiger auf ein Gerät instance Handle, das CM_Locate_DevNode abruft. Das abgerufene Handle ist an den lokalen Computer 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, ruft die Funktion ein Gerät instance Handle an das Gerät am Stamm der Gerätestruktur ab.

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

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt CM_Locate_DevNode CR_SUCCESS zurück. Andernfalls gibt die Funktion einen der CR_Xxx-Fehlercodes zurück, die in Cfgmgr32.h definiert sind.

Hinweise

Informationen zur Verwendung von Geräte- instance Handles, die an den lokalen Computer gebunden sind, finden Sie unter CM_Get_Child.

Hinweis

Der cfgmgr32.h-Header definiert CM_Locate_DevNode als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Universell
Header cfgmgr32.h (include Cfgmgr32.h)
Bibliothek Cfgmgr32.lib
DLL CfgMgr32.dll

Weitere Informationen

CM_Get_Child

CM_Locate_DevNode_Ex