SWbemPropertySet.Add 方法

SWbemPropertySet 对象的 Add 方法将 SWbemProperty 对象添加到 SWbemPropertySet 集合。 如果集合中已存在同名属性,则其内容将替换为新定义。

注意

在此操作之后,添加的属性的值为 NULL(未分配)。 若要设置或更改 WMI 属性的值,必须设置返回的 SWbemProperty 对象的 Value 属性。

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

语法

objProperty = .Add( _
  ByVal strName, _
  ByVal iCIMType, _
  [ ByVal bIsArray ], _
  [ ByVal iFlags ] _
)

parameters

strName [in]

必需。 新属性的名称。

iCIMType [输入参数]

必需。 一个整数,表示新属性的 CIMType 限定符。 请参阅 WbemCimTypeEnum 以获取包含 CIMType 限定符及其值的列表。

bIsArray [输入参数,可选]

指定属性是否为数组类型。 此参数的默认值为 FALSE。

iFlags [输入参数,可选]

保留,如果指定,则必须为零。

返回值

如果成功,此方法返回表示新属性的 SWbemProperty 对象。 否则,将返回 null 对象。

错误代码

Add 方法完成后,Err 对象可能包含以下错误代码之一。

wbemErrFailed - 2147749889 (0x80041001)

未知故障。

wbemErrInvalidParameter - 2147749896 (0x80041008)

指定的参数无效。

wbemErrOutOfMemory - 2147749894 (0x80041006)

内存不足,无法执行此方法。

wbemErrInvalidPropertyType - 2147749930

无法识别 CIMType 限定符。

示例

有关使用此方法的代码示例,请参阅 SWbemPropertySet 主题。

要求

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

另请参阅

SWbemPropertySet

SWbemPropertySet.Remove

SWbemProperty.Value