CM_Add_ID_ExA-Funktion (cfgmgr32.h)

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Add_ID .]

Die CM_Add_ID_Ex-Funktion fügt eine Geräte-ID (sofern nicht bereits vorhanden) an die Hardware-ID-Liste oder die Liste der kompatiblen ID eines Geräts instance auf dem lokalen oder einem Remotecomputer an.

Syntax

CMAPI CONFIGRET CM_Add_ID_ExA(
  DEVINST  dnDevInst,
  PSTR     pszID,
  ULONG    ulFlags,
  HMACHINE hMachine
);

Parameter

dnDevInst

Das vom Anrufer bereitgestellte Gerät instance Handle, das an den von hMachine bereitgestellten Maschinenhandle gebunden ist.

pszID

Vom Aufrufer bereitgestellter Zeiger auf eine NULL-beendete Geräte-ID-Zeichenfolge.

ulFlags

Vom Aufrufer bereitgestellte Flagkonstante, die die Liste angibt, an die die angegebene Geräte-ID angefügt werden soll. Die folgenden Flagkonstanten sind gültig.

Flagkonstante	Definition
CM_ADD_ID_COMPATIBLE	Die angegebene Geräte-ID sollte an die Liste der kompatiblen ID des jeweiligen Geräts instance angefügt werden.
CM_ADD_ID_HARDWARE	Die angegebene Geräte-ID sollte an die Hardware-ID-Liste des jeweiligen Geräts instance angefügt werden.

hMachine

Vom Aufrufer bereitgestelltes Computerhandle, an das das vom Aufrufer bereitgestellte Gerät instance Handle gebunden ist.

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 die Funktion CR_SUCCESS zurück. Andernfalls wird einer der CR_-Präfix-Fehlercodes zurückgegeben, die in Cfgmgr32.h definiert sind.

Hinweise

Jede angefügte Geräte-ID gilt als weniger kompatibel als IDs, die bereits in der angegebenen Liste vorhanden sind. Informationen zu Geräte-IDs, Hardware-IDs und kompatiblen IDs finden Sie unter Geräteidentifikationszeichenfolgen.

Aufrufer dieser Funktion müssen über SeLoadDriverPrivilege verfügen. (Berechtigungen werden in der Microsoft Windows SDK-Dokumentation beschrieben.)

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_Add_ID
CM_Get_Child_Ex