CM_Locate_DevNodeA-Funktion (cfgmgr32.h)
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_DevNodeA(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_A 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
| 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 |