SendIMEMessageExA function (ime.h)

[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 SendIMEMessageExA(
  HWND   ,
  LPARAM 
);

Parameters

unnamedParam1

unnamedParam2

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 code Description
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.

Note

The ime.h header defines SendIMEMessageEx as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header ime.h (include Windows.h)
Library User32.lib
DLL User32.dll