SWbemPrivilegeSet.Add メソッド

SWbemPrivilegeSet オブジェクトの Add メソッドは、SWbemPrivilegeSet コレクションに SWbemPrivilege オブジェクトを追加します。同じ名前の特権が既にコレクションに存在する場合は、置き換えられます。

この構文の説明については、「スクリプト API のドキュメントの表記規則」を参照してください。

構文

objPrivilege = .Add( _
  ByVal iPrivilege, _
  [ ByVal bIsEnabled ] _
)

iPrivilege: 必須。 WbemPrivilegeEnum グループの WMI 定数の 1 つ。これらの定数は、基本的に特定の特権を表す整数です。たとえば、コンピューターシステムをシャットダウンできる特権を追加するには、wbemPrivilegeShutdown 定数を使用します。スクリプトでは、23 (0x17) に相当する数値を使用する必要があります。これらの定数および関連する特権文字列の完全な一覧については、「特権定数」を参照してください。
bIsEnabled [省略可能]: この特権を有効または無効にするブール値。既定値は TRUE です。

成功した場合、このメソッドは新しい特権を表す SWbemPrivilege オブジェクトを返します。それ以外の場合は、null オブジェクトが返されます。

Add メソッドが完了すると、Err オブジェクトに次の一覧にあるエラーコードが含まれる場合があります。

このメソッドを使用するコード例については、SWbemPrivilegeSet のトピックで説明されています。