IWbemQualifierSet

成功した場合、VARIANT には修飾子に対応する正しい型と値が設定されます。この VARIANT に対しては VariantInit が呼び出されます。

値が不要になった時点で、このポインターに対して VariantClear を呼び出すのは呼び出し元の責任です。エラーコードが返された場合、pVal が指す VARIANT は変更されません。

このパラメーターが NULL の場合、パラメーターは無視されます。

NULL にすることはできません。書き込む修飾子の値を含む有効な VARIANT を指している必要があります。このポインターは読み取り専用として扱われます。値が不要になった後に、このポインターに対して VariantClear を呼び出すのは呼び出し元の責任です。

サポートされるのは、VT_I4、VT_R8、VT_BSTR、VT_BOOL 型のバリアントおよびその配列のみです。

この修飾子に設定する修飾子フレーバーです。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))

修飾子はローカライズされます。この定数の使用は、Amended フラグの使用と同じです。

次の定数のいずれかを指定します。

0 (ゼロ)

すべての修飾子の名前を返します。

WBEM_FLAG_LOCAL_ONLY

現在のプロパティまたはオブジェクトに固有の修飾子の名前のみを返します。現在の修飾子セットがプロパティを参照している場合は、クラス定義から伝播された修飾子ではなく、そのプロパティに固有の修飾子(オーバーライドを含む)のみを返します。現在の修飾子セットがインスタンスを参照している場合は、インスタンス固有の修飾子名のみを返します。現在の修飾子セットがクラスを参照している場合は、派生対象のクラスに固有の修飾子のみを返します。

WBEM_FLAG_PROPAGATED_ONLY

他のオブジェクトから伝播された修飾子の名前のみを返します。たとえば、現在の修飾子セットがプロパティを参照している場合は、そのプロパティ自体の修飾子ではなく、クラス定義からこのプロパティに伝播された修飾子のみを返します。現在の修飾子セットがインスタンスを参照している場合は、クラス定義から伝播された修飾子のみを返します。現在の修飾子セットがクラスを参照している場合は、親クラスから継承された修飾子名のみを返します。

要求された名前を含む新しい SAFEARRAY が作成されます。

エラーが返されないすべての場合において、新しい配列が作成され、pstrNames はその配列を指すように設定されます。これは、結果の配列の要素数がゼロの場合でも同様です。エラー時には、新しい SAFEARRAY は返されません。

列挙に含める修飾子を指定します。次の定数のいずれかでなければなりません。

0 (ゼロ)

すべての修飾子の名前を返します。

WBEM_FLAG_LOCAL_ONLY

現在のプロパティまたはオブジェクトに固有の修飾子の名前のみを返します。現在の修飾子セットがプロパティを参照している場合は、クラス定義から伝播された修飾子ではなく、そのプロパティに固有の修飾子(オーバーライドを含む)のみを返します。現在の修飾子セットがインスタンスを参照している場合は、インスタンス固有の修飾子名のみを返します。現在の修飾子セットがクラスを参照している場合は、派生対象のクラスに固有の修飾子のみを返します。

WBEM_FLAG_PROPAGATED_ONLY

他のオブジェクトから伝播された修飾子の名前のみを返します。たとえば、現在の修飾子セットがプロパティを参照している場合は、そのプロパティ自体の修飾子ではなく、クラス定義からこのプロパティに伝播された修飾子のみを返します。現在の修飾子セットがインスタンスを参照している場合は、クラス定義から伝播された修飾子のみを返します。現在の修飾子セットがクラスを参照している場合は、親クラスから継承された修飾子名のみを返します。

このパラメーターは修飾子の名前を受け取ります。WBEM_S_NO_ERROR が返される場合は、常に新しい BSTR が割り当てられます。

pstrName が NULL の場合は無視されます。それ以外の場合、呼び出し元は、このパラメーターが呼び出し時に有効な BSTR を指していないことを保証する必要があります。そうしないとメモリリークが発生します。また、呼び出し元は、返された文字列が不要になった時点で SysFreeString を呼び出す必要があります。