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

See also

Input Method Manager

Input Method Manager Functions