SWbemPrivilegeSet.AddAsString メソッド
SWbemPrivilegeSet オブジェクトの AddAsString メソッドを使用すると、特権文字列を使用して SWbemPrivilegeSet コレクションに特権を追加できます。 SWbemSecurity オブジェクトの特権を追加したり、特権を有効にしたりするには、このメソッドを使用します。 「VBScript を使用した特権操作の実行」を参照してください。
この構文の詳細については、「スクリプト API のドキュメント規則」を参照してください。
構文
objPrivilege = .AddAsString( _
ByVal strPrivilege, _
[ ByVal bIsEnabled ] _
)
パラメーター
-
strPrivilege
-
必須。 特権文字列の 1 つ。 これらの文字列および関連する WMI 定数の完全な一覧については、「特権定数」を参照してください。 すべての特権文字列は、特定の特権を表します。 たとえば、コンピューター システムのシャットダウンに使用する特権を追加するには、SeShutdownPrivilege 文字列を使用します。
-
bIsEnabled [オプション]
-
この特権を有効または無効にするブール値。 既定値は True です。
戻り値
成功した場合、このメソッドは新しい特権を表す SWbemPrivilege オブジェクトを返します。 それ以外の場合は、null オブジェクトが返されます。
エラー コード
AddAsString メソッドが完了すると、Err オブジェクトに次の一覧にあるエラー コードが含まれる場合があります。
-
wbemErrFailed - 2147749889 (0x80041001)
-
未定義のエラーが発生しました。
例
次の VBScript コード例では、Win32_TCPIPPrinterPort を使用してプリント サーバーの新しいポートを作成します。 この操作には SeLoadDriverPrivilege が必要です。 「特権操作の実行」を参照してください。
Set objWMIService = GetObject("Winmgmts:")
objWMIService.Security_.Privileges. _
AddAsString "SeLoadDriverPrivilege", True
Set objNewPort = objWMIService.Get _
("Win32_TCPIPPrinterPort").SpawnInstance_
objNewPort.Name = "IP_111.222.111.11"
objNewPort.Protocol = 1
objNewPort.HostAddress = "111.222.111.11"
objNewPort.PortNumber = "9999"
objNewPort.SNMPEnabled = False
objNewPort.Put_
このメソッドを使用するコード例については、SWbemPrivilegeSet のトピックでも説明されています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| Header |
|
| タイプ ライブラリ |
|
| [DLL] |
|
| CLSID |
CLSID_SWbemPrivilegeSet |
| IID |
IID_ISWbemPrivilegeSet |