Edit

ITfThreadMgrEx::ActivateEx method (msctf.h)

  • Article

The ITfThreadMgrEx::ActivateEx method is used by an application to initialize and activate TSF for the calling thread. Unlike ITfThreadMgr::Activate, ITfThreadMgrEx::ActivateEx can take a flag to specify how TSF is activated.

Syntax

HRESULT ActivateEx(
  [out] TfClientId *ptid,
  [in]  DWORD      dwFlags
);

Parameters

[out] ptid

[out] Pointer to a TfClientId value that receives a client identifier.

[in] dwFlags

Value Meaning
TF_TMAE_NOACTIVATETIP
 Text services will not be activated while ITfThreadMgrEx::ActivateEx is called. They will be activated when the calling thread has focus asynchronously.
TF_TMAE_SECUREMODE
 TSF is activated in secure mode. Only text services that support the secure mode will be activated.
TF_TMAE_UIELEMENTENABLEDONLY
 TSF activates only text services that are categorized in GUID_TFCAT_TIPCAP_UIELEMENTENABLED.
TF_TMAE_COMLESS
 TSF does not use COM. TSF activate only text services that are categorized in GUID_TFCAT_TIPCAP_COMLESS.
TF_TMAE_NOACTIVATEKEYBOARDLAYOUT
 TSF does not sync the current keyboard layout while ITfThreadMgrEx::ActivateEx() is called. The keyboard layout will be adjusted when the calling thread gets focus. This flag must be used with TF_TMAE_NOACTIVATETIP.

Return value

This method can return one of these values.

Value Description
S_OK
 The method was successful.
E_FAIL
 An unspecified error occurred.
E_INVALIDARG
 One or more parameters are invalid.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header msctf.h
DLL Msctf.dll
Redistributable TSF 1.0 on Windows 2000 Professional

See also

ITfThreadMgr::Activate

ITfThreadMgrEx