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	Wbemdisp.h
Typbibliothek	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemPrivilegeSet
IID	IID_ISWbemPrivilegeSet

Weitere Informationen

SWbemPrivilegeSet

Ausführen von privilegierten Vorgängen

Ausführen von privilegierten Vorgängen mithilfe von VBScript

SWbemPrivilegeSet.AddAsString

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

Berechtigungskonstanten