Export (0) Print
Expand All

SendIMEMessageEx function

[This function is obsolete and should not be used.]

Specifies an action or processing for the Input Method Editor (IME) through a specified subfunction.

Syntax


LRESULT WINAPI SendIMEMessageEx(
  _In_ HWND   hwnd,
  _In_ LPARAM lParam
);

Parameters

hwnd [in]

The window handle of the application that initiates the transaction. Generally, it is the window that has focus.

lParam [in]

A DWORD value in which the low-order word specifies a handle to the global memory that contains an IMESTRUCT structure. The global memory is allocated by specifying the GMEM_MOVEABLE and GMEM_SHARE flags in the GlobalAlloc function. The high-order word is reserved; it is not used.

Return value

The result of processing of the subfunction. If the result is not success, one of the following error codes is stored into the wParam of the IMESTRUCT structure.

Return codeDescription
IME_RS_DISKERROR

Disk error.

IME_RS_ERROR

General error.

IME_RS_ILLEGAL

Contains an illegal character.

IME_RS_INVALID

Invalid subfunction.

IME_RS_NEST

Subfunction is nested and, therefore, cannot be used.

IME_RS_NOIME

The IME has not been selected (has not been installed).

IME_RS_NOROOM

Short of area.

IME_RS_NOTFOUND

No candidate found.

IME_RS_SYSTEMMODAL

Windows is in system mode, data cannot be passed to the IME.

IME_RS_TOOLONG

Characters too long.

 

Remarks

SendIMEMessageEx guarantees the action stipulated in the specifications only for IMEs that support the WM_CONVERTREQUESTEX message. For an IME that does not support WM_CONVERTREQUESTEX, SendIMEMessageEx sends a WM_CONVERTREQUEST message to the IME and returns the contents of the wParam member of the IMESTRUCT structure. If the processing of the subfunction has not been completed normally, these functions set IME_RS_ERROR into wParam.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ime.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

Unicode and ANSI names

SendIMEMessageExW (Unicode) and SendIMEMessageExA (ANSI)

 

 

Community Additions

ADD
Show:
© 2015 Microsoft