Skip to main content
ImmDisableIME function

Disables the IME for a thread or for all threads in a process.

Syntax


BOOL ImmDisableIME(
  _In_  DWORD idThread
);

Parameters

idThread [in]

Identifier of the thread for which to disable the IME. The thread must be in the same process as the application calling this function. The application sets this parameter to 0 to disable the IME for the current thread. The application specifies -1 to disable the IME for all threads in the current process.

Return value

Returns TRUE if successful or FALSE otherwise.

Remarks

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

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

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Version

East Asian language support installed.

Header

Imm.h (include Windows.h)

Library

Imm32.lib

DLL

Imm32.dll

See also

Input Method Manager
Input Method Manager Functions