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 方法來註冊。