SWbemPrivilegeSet.AddAsString 方法

可以使用 SWbemPrivilegeSet 对象的 AddAsString 方法,使用特权字符串向 SWbemPrivilegeSet 集合添加特权。 使用此方法可添加特权或为 SWbemSecurity 对象启用特权。 请参阅使用 VBScript 执行特权操作

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

语法

objPrivilege = .AddAsString( _
  ByVal strPrivilege, _
  [ ByVal bIsEnabled ] _
)

parameters

strPrivilege

必需。 特权字符串之一。 有关这些字符串和关联的 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
标头
Wbemdisp.h
类型库
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemPrivilegeSet
IID
IID_ISWbemPrivilegeSet

另请参阅

SWbemPrivilegeSet

SWbemPrivilegeSet.Add

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

权限常量

执行特权操作

使用 VBScript 执行特权操作