[関数の検出は、[要件] セクションで指定されたオペレーティング システムで使用できます。 これは、以降のバージョンで変更または使用できない可能性があります。
特定の関数インスタンスのクエリを作成します。
構文
HRESULT CreateInstanceQuery(
[in] const WCHAR *pszFunctionInstanceIdentity,
[in] IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
[in, out] FDQUERYCONTEXT *pfdqcQueryContext,
[out] IFunctionInstanceQuery **ppIFunctionInstanceQuery
);
パラメーター
[in] pszFunctionInstanceIdentity
関数インスタンスの識別子。
[in] pIFunctionDiscoveryNotification
呼び出し元のアプリケーションによって実装される IFunctionDiscoveryNotification インターフェイスへのポインター。 指定すると、関数検出変更通知プロセスが有効になります。 このパラメーターには NULL を指定できます。ただし、ネットワーク プロバイダーにはが必要です。
[in, out] pfdqcQueryContext
クエリが作成されたコンテキストへのポインター。 FDQUERYCONTEXT 型は DWORDLONG として定義されます。
[out] ppIFunctionInstanceQuery
生成されたクエリを返すために使用される IFunctionInstanceQuery インターフェイス ポインターへのポインター。
戻り値
可能な戻り値は次のとおりですが、これらに限定されません。
| リターン コード | 説明 |
|---|---|
|
メソッドは正常に完了しました。 |
|
ppIFunctionInstanceQuery が NULL です。 |
|
メソッドは、この操作を実行するために必要なメモリを割り当てることができません。 |
注釈
関数探索ネットワーク プロバイダーは、 IFunctionDiscoveryNotification インターフェイスを介してのみインスタンスを返します。
このメソッドは、クエリ呼び出しのみを初期化します。 ppIFunctionInstanceQuery で返される IFunctionInstanceQuery インターフェイスの Execute メソッドは、クエリを実行してデータを返すために呼び出す必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | functiondiscoveryapi.h |
| [DLL] | FunDisc.dll |