ITfThreadMgr2：：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 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 msctf.h

另請參閱

ITfThreadMgr2