ImeConvertString

ImeConvertString

This entry is called to convert the given input string.

Format:

APIRET APIENTRY ImeConvertString(
                HIMI hImi,
                PSZ pszInput,
                PCANDIDATELISTHEADER pCandidateListHeader,
                PULONG pulBufferLength,
                ULONG ulFlag )

Parameters:

hImi(input) : IMInstance handle.

pszInput(input) : Input string to be converted

pCandidateListHeader(output) : Conversion result.

pulBufferLength(input/output) : On input, length of pCandidateList is required. On output, total buffer size in bytes which is  actually copied to pCandidateList is returned. If this parameter is zero on input, total buffer size for whole CandidateL
 returned.

ulFlag(input) : Request type which is one of the followings

    ICS_CONVERSION - Reading string -> Result string
    ICS_REVERSECONVERSION - Result string -> Reading String

Returns:

Success indicator

0 : Successful completion

other : Error occurred
                ERROR_NOT_SUPPORTED : This function is not supported.

Remarks: IME Should not call ImRequestEvent call. This API is used just for getting a conversion result for Level 3 applications.