SWbemPrivilegeSet.Add 方法

SWbemPrivilegeSet 对象的 Add 方法将 SWbemPrivilege 对象添加到 SWbemPrivilegeSet 集合。 如果集合中已存在同名的特权,则会替换该特权。

有关此语法的说明,请参阅脚本 API 的文档约定

语法

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

parameters

iPrivilege

必需。 WbemPrivilegeEnum 组中的 WMI 常量之一。 这些常量本质上是代表具体特权的整数。 例如,若要添加允许你关闭计算机系统的特权,请使用 wbemPrivilegeShutdown 常量。 在脚本中,必须使用 23 (0x17) 的等效数值。 有关这些常量和相关特权字符串的完整列表,请参阅特权常量

bIsEnabled [可选]

启用或禁用此特权的布尔值。 默认值为 TRUE。

返回值

如果成功,此方法会返回表示新特权的 SWbemPrivilege 对象。 否则会返回 null 对象。

错误代码

Add 方法完成后,Err 对象可能包含以下列表中的错误代码。

wbemErrFailed - 2147749889 (0x80041001)

错误。

示例

SWbemPrivilegeSet 主题中介绍了使用此方法的代码示例。

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
标头
Wbemdisp.h
类型库
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemPrivilegeSet
IID
IID_ISWbemPrivilegeSet

另请参阅

SWbemPrivilegeSet

执行特权操作

使用 VBScript 执行特权操作

SWbemPrivilegeSet.AddAsString

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

权限常量