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_BSTR、VT_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 に含まれる値の一覧です。

要件

こちらもご覧ください

修飾子のフレーバー