ITfThreadMgr2::ActivateEx method (msctf.h)

Initializes and activates TSF for the calling thread with a flag that specifies 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 this method 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 this method 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 8 [desktop apps | UWP apps]
Minimum supported server	Windows Server 2012 [desktop apps | UWP apps]
Target Platform	Windows
Header	msctf.h

See also

ITfThreadMgr2