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 |
标头 |
|
类型库 |
|
DLL |
|
CLSID |
CLSID_SWbemPrivilegeSet |
IID |
IID_ISWbemPrivilegeSet |