ITfThreadMgr::GetFunctionProvider メソッド (msctf.h)

指定した関数プロバイダーオブジェクトを取得します。

構文

HRESULT GetFunctionProvider(
  [in]  REFCLSID            clsid,
  [out] ITfFunctionProvider **ppFuncProv
);

[in] clsid

目的の関数プロバイダーの CLSID。呼び出し元のスレッドに登録されている関数プロバイダーの CLSID、または次の定義済みの値のいずれかを指定できます。

値	意味
GUID_SYSTEM_FUNCTIONPROVIDER	TSF システム関数プロバイダーを取得します。
GUID_APP_FUNCTIONPROVIDER	現在のアプリケーションによって実装されている関数プロバイダーを取得します。アプリケーション自体が関数プロバイダーとして登録されていない場合、このオブジェクトは使用できません。

[out] ppFuncProv

関数プロバイダーを受け取る ITfFunctionProvider インターフェイスへのポインター。

このメソッドは、これらの値のいずれかを返すことができます。

値	説明
S_OK	メソッドは正常に実行されました。
TF_E_NOPROVIDER	clsid に一致する関数プロバイダーが使用できません。
E_FAIL	GUID_SYSTEM_FUNCTIONPROVIDERが要求されましたが、取得できません。

関数プロバイダーは、IID_ITfFunctionProviderを使用して TSF マネージャー ITfSourceSingle::AdviseSingleSink メソッドを呼び出して登録します。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	msctf.h
[DLL]	Msctf.dll
再頒布可能パッケージ	Windows 2000 Professional 上の TSF 1.0