次の方法で共有


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

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

識別子に基づいて、指定された関数インスタンスを取得します。

構文

HRESULT GetInstance(
  [in]  const WCHAR       *pszFunctionInstanceIdentity,
  [out] IFunctionInstance **ppIFunctionInstance
);

パラメーター

[in] pszFunctionInstanceIdentity

関数インスタンスの識別子 ( GetID を参照)。

[out] ppIFunctionInstance

インターフェイスを返すために使用される IFunctionInstance インターフェイス ポインターへのポインター。

戻り値

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

リターン コード/値 説明
S_OK
メソッドは正常に完了しました。
E_INVALIDARG
pszFunctionInstanceIdentity の値が無効です。
E_OUTOFMEMORY
メソッドは、この操作を実行するために必要なメモリを割り当てることができません。
HRESULT_FROM_WIN32(ERROR_OBJECT_NOT_FOUND)
0x800710d8
指定した ID で表される関数インスタンスがこのコンピューターに存在しません。
E_PENDING
呼び出しは、結果を非同期的に返すプロバイダーに対して実行されました。

注釈

一部の関数検出プロバイダーは、 IFunctionDiscoveryNotification インターフェイスを使用してクエリ結果を返します。 GetInstance では、この方法で返される関数インスタンスが見つからないので、E_PENDINGで失敗します。 クライアントは、IFunctionDiscovery インターフェイスの CreateInstanceQuery メソッドを使用して、このようなプロバイダーの関数インスタンスを検索することをお勧めします。

要件

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

こちらもご覧ください

IFunctionDiscovery