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