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.
LRESULT SendIMEMessageExA( HWND , LPARAM );
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.
||Contains an illegal character.|
||Subfunction is nested and, therefore, cannot be used.|
||The IME has not been selected (has not been installed).|
||Short of area.|
||No candidate found.|
||Windows is in system mode, data cannot be passed to the IME.|
||Characters too long.|
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.
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.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Header||ime.h (include Windows.h)|