ImmDisableLegacyIME function (imm.h)

Indicates that this thread is a Windows Store app UI thread.

Syntax

BOOL ImmDisableLegacyIME();

Return value

Returns TRUE if successful; otherwise, FALSE.

Remarks

Windows Store app brokers such as explorer.exe should call this function in Windows Store app UI threads to ensure that only IMEs that are compatible with Windows Store apps are made available. Those Windows Store app threads that don't require IME input should call ImmDisableIME to disable IMM entirely for that thread.

The app must call this function before the first top-level window in the thread receives the WM_CREATE message. Thus, the app must call this function in one of the following places:

  • Any time before CreateWindow is called to create the first top-level window.
  • In the WM_NCCREATE handler for the first top-level window.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only],East Asian language support installed.
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header imm.h (include Immdev.h, Windows.h)
Library Imm32.lib
DLL Imm32.dll

See also

Input Method Manager

Input Method Manager Functions