Edit

Share via

ITfTextInputProcessorEx::ActivateEx method (msctf.h)

  • Article

The ITfTextInputProcessorEx::ActivateEx method activates a text service when a user session starts. If the text service implements ITfTextInputProcessorEx and ActivateEx is called, ITfTextInputProcessor::Activate will not be called.

Syntax

HRESULT ActivateEx(
  [in] ITfThreadMgr *ptim,
  [in] TfClientId   tid,
  [in] DWORD        dwFlags
);

Parameters

[in] ptim

[in] Pointer to the ITfThreadMgr interface for the thread manager that owns the text service.

[in] tid

[in] Specifies the client identifier for the text service.

[in] dwFlags

[in] The combination of the following bits:

Value Meaning
TF_TMAE_SECUREMODE
 A text service is activated as secure mode. A text service may not want to show the setting dialog box.
TF_TMAE_COMLESS
 A text service is activated as com less mode. TSF was activated without COM. COM may not be initialized or COM may be initialized as MTA.
TF_TMAE_WOW16
 The current thread is 16 bit task.
TF_TMAE_CONSOLE
 A text service is activated for console usage.

Return value

The TSF manager ignores the return value of this method.

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