Share via

IWbemQualifierSet：:P ut 方法 (wbemcli.h)

  • 项目

IWbemQualifierSet：:P ut 方法写入命名限定符和值。 新的限定符将覆盖同名的上一个值。 如果限定符不存在，则会创建一个。

有时无法写入限定符的值，例如，如果限定符是从另一个对象传播的。 通常，传播的限定符是只读的，但可以重写它们。 有关详细信息，请参阅限定符特色信息。

使用 密钥 限定符时，无需指定任何风格或传播规则。

用户不得创建名称以下划线 (_) 开头或结尾的限定符。 此为系统类和属性保留。

语法

HRESULT Put(
  [in] LPCWSTR wszName,
  [in] VARIANT *pVal,
  [in] long    lFlavor
);

参数

[in] wszName

正在写入的限定符的名称。 指针被视为只读。

[in] pVal

不能为 NULL。 这必须指向包含要写入的限定符值的有效 VARIANT 。 指针被视为只读。 调用方负责在不需要值后在此指针上调用 VariantClear 。

仅支持 VT_I4、 VT_R8、 VT_BSTRVT_BOOL 类型的变体和数组。

[in] lFlavor

此限定符的所需限定符风格。 以下列表列出了 lFlavor 的相应常量。 默认值为零 (0)。

WBEM_FLAVOR_OVERRIDABLE (0 (0x0) )

可以在派生类或实例中重写限定符值。 这是默认值。 使用此常量与使用 EnableOverride 标志相同。

WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE (1 (0x1) )

限定符传播到实例。 使用此常量与使用 ToInstance 标志相同。

WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS (2 (0x2) )

限定符传播到派生类。 使用此常量与使用 ToSubClass 标志相同。

WBEM_FLAVOR_NOT_OVERRIDABLE (16 (0x10) )

不能在派生类或实例中重写限定符值。 使用此常量与使用 DisableOverride 标志相同。

WBEM_FLAVOR_AMENDED (128 (0x80) )

限定符已本地化。 使用此常量与使用 已修订 标志相同。

返回值

此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 HRESULT 中包含的值。

要求

要求 值
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wbemcli.h (包括 Wbemidl.h)
Library Wbemuuid.lib
DLL Fastprox.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll

另请参阅

限定符风格