ImmDisableIME

The ImmDisableIME function disables the input method editor (IME) for a thread or all threads in a process.

BOOL ImmDisableIME(
  DWORD idThread 
);

Parameters

idThread

[in] Identifier of the thread for which the IME is to be disabled. The thread must be in the same process as the caller of this function. If idThread is zero, the IME for the current thread is disabled. If idThread is –1, the IME is disabled for all threads in the current process.

Return Values

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE.

Remarks

The application must call this function before the first top-level window in the thread receives the WM_CREATE message. This means 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 first top-level window's WM_NCCREATE handler

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 98.
  Header: Declared in Imm.h.
  Library: Use Imm32.lib.

See Also

Input Method Editor Overview, Input Method Editor Functions, CreateWindow, WM_CREATE, WM_NCCREATE