CM_Locate_DevNodeA Funktion (cfgmgr32.h)
Die CM_Locate_DevNode-Funktion ruft ein Geräteinstanzhandle für den Geräteknoten ab, der einer angegebenen Geräteinstanz-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 eine Geräteinstanz, die abgerufen CM_Locate_DevNode. Das abgerufene Handle ist an den lokalen Computer gebunden.
[in, optional] pDeviceID
Ein Zeiger auf eine MIT NULL beendete Zeichenfolge, die eine Geräteinstanz-IDdarstellt. Wenn dieser Wert NULL-ist oder wenn er auf eine leere Zeichenfolge zeigt, ruft die Funktion ein Geräteinstanzhandle an das Gerät am Stamm der Gerätestrukturab.
[in] ulFlags
Eine Variable vom ULONG-Typ, die einen der folgenden Flagwerte bereitstellt, die angewendet werden, wenn der Aufrufer einen Geräteinstanzbezeichner bereitstellt:
CM_LOCATE_DEVNODE_NORMAL
Die Funktion ruft das Geräteinstanzhandle 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äteinstanzhandle für das angegebene Gerät ab, wenn das Gerät derzeit in der Gerätestruktur konfiguriert ist oder das Gerät ein nicht vorhandener Geräte ist, der derzeit nicht in der Gerätestruktur konfiguriert ist.
CM_LOCATE_DEVNODE_CANCELREMOVE
Die Funktion ruft ein Geräteinstanzhandle für das angegebene Gerät ab, wenn das Gerät derzeit in der Gerätestruktur oder im Prozess der Entfernung aus der Gerätestruktur konfiguriert ist. Wenn das Gerät 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.hdefiniert sind.
Bemerkungen
Informationen zur Verwendung von Geräteinstanzhandles, die an den lokalen Computer gebunden sind, finden Sie unter CM_Get_Child.
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform- | Universal |
| Header- | cfgmgr32.h (enthalten Cfgmgr32.h) |
| Library | Cfgmgr32.lib |
| DLL- | CfgMgr32.dll |