次の方法で共有

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

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

AddQueryConstraint メソッドは、クエリにクエリ制約を追加します。

このメソッドを使用すると、アプリケーションは、この制約を満たすインスタンスのみに結果セットをフィルター処理できます。

構文

HRESULT AddQueryConstraint(
  [in] const WCHAR *pszConstraintName,
  [in] const WCHAR *pszConstraintValue
);

パラメーター

[in] pszConstraintName

クエリ制約。

[in] pszConstraintValue

制約値。

戻り値

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

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
E_OUTOFMEMORY
 メソッドは、この操作を実行するために必要なメモリを割り当てることができません。

注釈

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

IFunctionInstanceCollectionQuery オブジェクトにすべてのサブカテゴリが含まれており、pszConstraintName パラメーターを FD_QUERYCONSTRAINT_PROVIDERINSTANCEID に設定して AddQueryConstraint メソッドが呼び出された場合、AddQueryConstraint はエラーで失敗します。 このエラーを回避するには、すべてのサブカテゴリを含まない IFunctionInstanceCollectionQuery オブジェクトを作成します。 このようなオブジェクトを作成するには、fIncludeAllSubCategories パラメーターを false に設定して CreateInstanceCollectionQuery を呼び出します。

要件

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

こちらもご覧ください

制約の定義

関数検出クエリ

IFunctionInstanceCollectionQuery

  • Last updated on