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 专业版上的 TSF 1.0