SWbemQualifierSet.Add 方法

SWbemQualifierSet 对象的 Add 方法可将 SWbemQualifier 对象添加到 SWbemQualifierSet 集合。 如果集合中已存在同名的限定符，则会替换该限定符。

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

语法

objQualifier = .Add( _
  ByVal strName, _
  ByVal varVal, _
  [ ByVal bPropagatesToSubclasses ], _
  [ ByVal bPropagatesToInstances ], _
  [ ByVal bOverridable ], _
  [ ByVal iFlags ] _
)

parameters

strName [in]

必需。 新限定符的名称。

varVal [输入参数]

必需。 新限定符的变体值。

bPropagatesToSubclasses [in, optional]

一个布尔值，指示这个新限定符是否传播到子类。 默认值为 TRUE。

bPropagatesToInstances [in, optional]

一个布尔值，指示这个新限定符是否传播到实例。 默认值为 TRUE。

bOverridable [in, optional]

一个布尔值，指示在传播时是否可以重写此限定符。 默认值为 TRUE。

iFlags [输入参数，可选]

保留。 默认值为 0。

返回值

如果成功，此方法返回表示新限定符的 SWbemQualifier 对象。 否则，将返回 null 对象。

错误代码

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

wbemErrInvalidParameter - 2147749896 (0x80041008)

iFlags 参数无效。

wbemErrFailed - 2147749889 (0x80041001)

错误。

wbemErrCannotBeKey - 2147749919 (0x8004101F)

此处存在非法尝试，即对不能为键的属性指定 Key 限定符。 键可以在对象的类定义中指定，但不能在每个实例基础上更改。

wbemErrInvalidQualifierType - 2147749929 (0x80041029)

varVal 参数的限定符类型不合法。

wbemErrOverrideNotAllowed - 2147749914 (0x8004101A)

无法对此限定符执行 SWbemQualifierSet.Add 操作，因为所属对象不允许重写。

要求

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

另请参阅

SWbemQualifierSet

SWbemQualifierSet.Remove