IActiveIME::ConversionList Method

---

Obtains a converted result list from another character or string.

Syntax

HRESULT ConversionList(
    HIMC hIMC,
    LPWSTR szSource,
    UINT uFlag,
    UINT uBufLen,
    CANDIDATELIST *pDest,
    UINT *puCopied
);

Parameters

hIMC

[in] Handle to the input context.

szSource

[in] Address of a string value that contains the character string to be converted.

uFlag

[in] Unsigned integer value that specifies the conversion flags.

uBufLen

[in] Unsigned integer value that specifies the length of the buffer, in bytes.

pDest

[out] Address of a buffer that receives the CANDIDATELIST structure.

puCopied

[out] Address of an unsigned integer value that indicates the number of bytes received.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

This method maps to the ImeConversionList function documented in the Microsoft® Windows® 2000 Driver Development Kit.

This method is intended to be called by an application or an Active IME without generating any IME-related messages. Therefore, an Active IME should not generate any IME-related messages in this method.