CM_Add_ID_ExW-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_ExW(
  [in]           DEVINST  dnDevInst,
  [in]           PWSTR    pszID,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parameter

[in] dnDevInst

Vom Anrufer bereitgestelltes Gerät instance Handle, das an den von dem bereitgestellten Computerhandle gebunden ist

hMachine

.

[in] pszID

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

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

[in, optional] 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