次の方法で共有


IFunctionDiscovery::CreateInstanceQuery メソッド (functiondiscoveryapi.h)

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

特定の関数インスタンスのクエリを作成します。

構文

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 インターフェイス ポインターへのポインター。

戻り値

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

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

注釈

関数探索ネットワーク プロバイダーは、 IFunctionDiscoveryNotification インターフェイスを介してのみインスタンスを返します。

このメソッドは、クエリ呼び出しのみを初期化します。 ppIFunctionInstanceQuery で返される IFunctionInstanceQuery インターフェイスの Execute メソッドはクエリを実行してデータを返すために呼び出す必要があります。

要件

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

こちらもご覧ください

関数検出クエリ

IFunctionDiscovery