SWbemPrivilegeSet.Add-Methode
Die Add-Methode des SWbemPrivilegeSet-Objekts fügt der SWbemPrivilegeSet-Sammlung ein SWbemPrivilege-Objekt hinzu. Wenn bereits eine Berechtigung mit dem gleichen Namen in der Auflistung vorhanden ist, wird sie ersetzt.
Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripterstellungs-API.
Syntax
objPrivilege = .Add( _
ByVal iPrivilege, _
[ ByVal bIsEnabled ] _
)
Parameter
-
iPrivilege
-
Erforderlich. Eine der WMI-Konstanten aus der Gruppe WbemPrivilegeEnum. Diese Konstanten sind im Wesentlichen ganze Zahlen, die bestimmte Berechtigungen darstellen. Um beispielsweise die Berechtigung hinzuzufügen, mit der Sie ein Computersystem herunterfahren können, verwenden Sie die Konstante wbemPrivilegeShutdown. In einem Skript müssen Sie die numerische Entsprechung von 23 (0x17. Eine vollständige Liste dieser Konstanten und der zugeordneten Berechtigungszeichenfolgen finden Sie unter Privilege Constants.
-
bIsEnabled [ Optional]
-
Boolescher Wert, der diese Berechtigung aktiviert oder deaktiviert. Der Standardwert ist TRUE.
Rückgabewert
Bei Erfolg gibt die Methode ein SWbemPrivilege-Objekt zurück, das die neue Berechtigung darstellt. Andernfalls wird ein NULL-Objekt zurückgegeben.
Fehlercodes
Nach Abschluss der Add-Methode kann das Err-Objekt den Fehlercode in der folgenden Liste enthalten.
-
wbemErrFailed – 2147749889 (0x80041001)
-
Unbekannter Fehler.
Beispiele
Ein Codebeispiel mit dieser Methode wird im Thema SWbemPrivilegeSet beschrieben.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID _ SWbemPrivilegeSet |
| IID |
IID _ ISWbemPrivilegeSet |