ITfThreadMgr2::GetFunctionProvider method (msctf.h)

Obtains the specified function provider object.

Syntax

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

Parameters

[in] clsid

CLSID of the desired function provider. This can be the CLSID of a function provider registered for the calling thread or one of the following predefined values.

Value Meaning
GUID_SYSTEM_FUNCTIONPROVIDER
Obtains the TSF system function provider.
GUID_APP_FUNCTIONPROVIDER
Obtains the function provider implemented by the current application. This object is not available if the application does not register itself as a function provider.

[out] ppFuncProv

Pointer to a ITfFunctionProvider interface that receives the function provider.

Return value

This method can return one of these values.

Value Description
S_OK
The method was successful.
TF_E_NOPROVIDER
No function provider matching clsid was available.
E_FAIL
GUID_SYSTEM_FUNCTIONPROVIDER was requested, but cannot be obtained.

Remarks

A function provider registers by calling the TSF manager ITfSourceSingle::AdviseSingleSink method with IID_ITfFunctionProvider.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header msctf.h

See also

ITfThreadMgr2