QualifierSet_Put 函式
寫入具名限定詞與值。 新的限定詞會覆寫相同名稱的先前值。 如果限定詞不存在，則會建立限定詞。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
HRESULT QualifierSet_Put (
[in] int vFunc,
[in] IWbemQualifierSet* ptr,
[in] LPCWSTR wszName,
[in] VARIANT* pVal,
[in] LONG lFlavor
);
參數
vFunc
[in] 此參數未使用。
ptr
[in] IWbemQualifierSet 執行個體的指標。
wszName
[in] 要寫入的限定詞名稱。
pVal
[in] 一個指標，指向包含要寫入之限定詞的有效 VARIANT。 這個參數不可以是 null。
lFlavor
[in] 下列其中一個常數，定義此限定詞所需的限定詞標註。 預設值為 WBEM_FLAVOR_OVERRIDABLE (0)。
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_FLAVOR_OVERRIDABLE |
0 | 限定詞可在衍生類別或執行個體中覆寫。 這是預設值。 |
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE |
1 | 限定詞會傳播到執行個體。 |
WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS |
2 | 限定詞會傳播到衍生類別。 |
WBEM_FLAVOR_NOT_OVERRIDABLE |
0x10 | 無法在衍生類別或執行個體中覆寫限定詞。 |
WBEM_FLAVOR_AMENDED |
0x80 | 限定詞已當地語系化。 |
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_E_CANNOT_BE_KEY |
0x8004101f | 出現不合法嘗試要在不可能是索引鍵的屬性上指定索引鍵限定詞。 索引鍵會在物件的類別定義中指定，並且不能對每個執行個體進行變更。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | 參數無效。 |
WBEM_E_INVALID_QUALIFIER_TYPE |
0x80041029 | pVal 參數不是合法的限定詞型別。 |
WBEM_E_OVERRIDE_NOT_ALLOWED |
0x8004101a | 無法在限定詞上呼叫 QualifierSet_Put 方法，因為擁有物件不允許覆寫。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裝向 IWbemQualifierSet::Put 方法發出的呼叫。
規格需求
平台：請參閱系統需求。
標頭：WMINet_Utils.idl
.NET Framework版本：自 4.7.2 起可用
