Edit

Share via

InitLocalMsCtfMonitor function (msctfmonitorapi.h)

  • Article
  • 02/22/2024

The InitLocalMsCtfMonitor function initializes TextServicesFramework on the current desktop and prepares the floating language bar, if necessary. This function must be called on the app's desktop.

Syntax

HRESULT InitLocalMsCtfMonitor(
  [in] DWORD dwFlags
);

Parameters

[in] dwFlags

This is a combination of the following flags:

Value Meaning
ILMCM_CHECKLAYOUTANDTIPENABLED
 InitLocalMsCtfMonitor forcefully checks the available keyboard layout or text service. If there is no secondary keyboard layout or text services, it does not initialize TextServicesFramework on the desktop.
ILMCM_LANGUAGEBAROFF
 Starting with Windows 8: A local language bar is not started for the current desktop.

Return value

Value Meaning
S_OK The function was successful.
E_FAIL An unspecified error occurred.

Remarks

If this function was successful, UninitLocalMsCtfMonitor needs to be called before the caller thread is terminated or the desktop is switched.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header msctfmonitorapi.h
Library MsCtfMonitor.lib
DLL Msctf.dll

Additional resources