[関数検出は、[要件] セクションで指定したオペレーティング システムで使用できます。 以降のバージョンでは変更または使用できない場合があります。]
識別子に基づいて、指定された関数インスタンスを取得します。
構文
HRESULT GetInstance(
[in] const WCHAR *pszFunctionInstanceIdentity,
[out] IFunctionInstance **ppIFunctionInstance
);
パラメーター
[in] pszFunctionInstanceIdentity
関数インスタンスの識別子 ( GetID を参照)。
[out] ppIFunctionInstance
インターフェイスを返すために使用される IFunctionInstance インターフェイス ポインターへのポインター。
戻り値
可能な戻り値には、次のものが含まれますが、これらに限定されません。
| リターン コード/値 | 説明 |
|---|---|
|
メソッドは正常に完了しました。 |
|
pszFunctionInstanceIdentity の値が無効です。 |
|
メソッドは、この操作を実行するために必要なメモリを割り当てることができません。 |
|
指定した ID で表される関数インスタンスがこのコンピューターに存在しません。 |
|
呼び出しは、結果を非同期的に返すプロバイダーに対して実行されました。 |
注釈
一部の関数検出プロバイダーは、 IFunctionDiscoveryNotification インターフェイスを使用してクエリ結果を返します。 GetInstance では、この方法で返される関数インスタンスが見つからないので、E_PENDINGで失敗します。 クライアントは、IFunctionDiscovery インターフェイスの CreateInstanceQuery メソッドを使用して、このようなプロバイダーの関数インスタンスを検索することをお勧めします。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | functiondiscoveryapi.h |
| [DLL] | FunDisc.dll |