IFunctionInstanceCollectionQuery::AddPropertyConstraint メソッド (functiondiscoveryapi.h)

[関数検出は、[要件] セクションで指定したオペレーティング システムで使用できます。 以降のバージョンでは変更または使用できない場合があります。]

プロパティ制約をクエリに追加します。

このメソッドは、指定された制約に一致するプロパティ キー (PKEY) を持つ関数インスタンスのみにクエリ結果を制限します。

構文

HRESULT AddPropertyConstraint(
  [in] REFPROPERTYKEY     Key,
  [in] const PROPVARIANT  *pv,
  [in] PropertyConstraint enumPropertyConstraint
);

パラメーター

[in] Key

制約のプロパティ キー (PKEY)。 PKEYs の詳細については、「 キー定義」を参照してください。

[in] pv

制約に使用される PROPVARIANT 。 この型は 、Key に関連付けられている PROPVARIANT 型と一致する必要があります。

次に、使用可能な値を示します。 組み込みプロバイダーでサポートされている PROPVARIANT 型のサブセットのみをプロパティ制約として使用できることに注意してください。

VT_BOOL

VT_I2

VT_I4

VT_I8

VT_INT

VT_LPWSTR

VT_LPWSTR|VT_VECTOR

VT_UI2

VT_UI4

VT_UI8

VT_UINT

[in] enumPropertyConstraint

制約の PKEY と関数インスタンスの PKEY を比較するときに使用する比較の種類を指定する PropertyConstraint 値。

戻り値

可能な戻り値には、次のものが含まれますが、これらに限定されません。

リターン コード	説明
S_OK	メソッドは正常に完了しました。
E_OUTOFMEMORY	メソッドは、この操作を実行するために必要なメモリを割り当てることができません。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	クエリに指定された制約はサポートされていません。 特定の VARENUM 型に対して制約がサポートされていないか、 VARENUM 型がまったくサポートされていません。

解説

関数インスタンスは、関数インスタンスの PKEY の PROPVARIANT 型が制約の PKEY の PROPVARIANT 型と一致し、関数インスタンスの PKEY 値が enumPropertyConstraint で指定された比較演算子を使用して制約の PKEY 値と一致する場合にのみ、プロパティ制約と一致します。

複数の制約を追加する場合は、クエリを満たすためにすべての制約をサポートする必要があります。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	functiondiscoveryapi.h
[DLL]	FunDisc.dll

関連項目

関数検出クエリ

IFunctionInstanceCollectionQuery