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
Wbemdisp.h
Typbibliothek
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemPrivilegeSet
IID
IID _ ISWbemPrivilegeSet

Weitere Informationen

SWbemPrivilegeSet

Ausführen privilegierter Vorgänge

Ausführen privilegierter Vorgänge mit VBScript

SWbemPrivilegeSet.AddAsString

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

Berechtigungskonst constants