共用方式為

WbebemQualifierSet：: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)
程式庫 Wbemuuid.lib
Dll Fastprox.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll

另請參閱

限定符類別