CM_Add_ID_ExA Funktion (cfgmgr32.h)
[Ab Windows 8 und Windows Server 2012 wurde diese Funktion veraltet. Verwenden Sie stattdessen CM_Add_ID .]
Die funktion CM_Add_ID_Ex fügt eine Geräte-ID (sofern noch nicht vorhanden) an die Hardware-ID-Liste oder die kompatible ID-Liste einer Geräteinstanz an, entweder auf dem lokalen oder einem Remotecomputer.
Syntax
CMAPI CONFIGRET CM_Add_ID_ExA(
DEVINST dnDevInst,
PSTR pszID,
ULONG ulFlags,
HMACHINE hMachine
);
Parameter
dnDevInst
Vom Anrufer bereitgestellte Geräteinstanzhandle, die an den von hMachine bereitgestellten Maschinenhandle gebunden ist.
pszID
Aufrufer-bereitgestellter Zeiger auf eine NULL-beendete Geräte-ID-Zeichenfolge.
ulFlags
Die 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.
| Flag-Konstante | Definition |
|---|---|
| CM_ADD_ID_COMPATIBLE | Die angegebene Geräte-ID sollte an die kompatible ID-Liste der bestimmten Geräteinstanz angefügt werden. |
| CM_ADD_ID_HARDWARE | Die angegebene Geräte-ID sollte an die Hardware-ID-Liste der jeweiligen Geräteinstanz angefügt werden. |
hMachine
Der vom Anrufer bereitgestellte Computerhandle, an den der vom Anrufer bereitgestellte Geräteinstanzhandpunkt gebunden ist.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird eine der in Cfgmgr32.h definierten CR_-präfixierten Fehlercodes zurückgegeben.
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äteinstanzhandles, 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 späteren Betriebssystemen entfernt, damit Sie nicht auf Remotecomputer zugreifen können, wenn sie auf diesen Versionen von Windows ausgeführt werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Header | cfgmgr32.h (include Cfgmgr32.h) |
| Bibliothek | Cfgmgr32.lib |