SWbemPrivilegeSet.Add-Methode
Die Add-Methode des SWbemPrivilegeSet-Objekts fügt der SWbemPrivilegeSet-Auflistung ein SWbemPrivilege-Objekt hinzu. Ist in der Auflistung bereits eine Berechtigung mit dem gleichen Namen vorhanden, wird sie ersetzt.
Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skript-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 23 (0x17) verwenden. Eine vollständige Liste dieser Konstanten und der zugehörigen Berechtigungszeichenfolgen finden Sie unter Berechtigungskonstanten.
-
bIsEnabled [optional]
-
Ein boolescher Wert, der diese Berechtigung aktiviert oder deaktiviert. Der Standardwert ist TRUE.
Rückgabewert
Bei erfolgreicher Ausführung 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 enthält das Err-Objekt möglicherweise den Fehlercode in der folgenden Liste.
-
wbemErrFailed – 2147749889 (0x80041001)
-
Unbekannter Fehler.
Beispiele
Ein Codebeispiel, das diese Methode verwendet, wird im Thema SWbemPrivilegeSet beschrieben.
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 |