IActiveIME::ConversionList method

Gets a converted result list from another character or string.

Syntax

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

Parameters

• hIMC [in]
  A handle to the input context.

• szSource [in]
  The address of a string value that contains the character string to be converted.

• uFlag [in]
  An unsigned integer value that specifies the conversion flags.

• uBufLen [in]
  An unsigned integer value that specifies the length of the buffer, in bytes.

• pDest [out]
  The address of a buffer that receives the CANDIDATELIST structure.

• puCopied [out]
  The address of an unsigned integer value that indicates the number of bytes received.

Return value

Returns S_OK if successful, or an error value otherwise.

Remarks

This method maps to the ImeConversionList function documented in the Windows 2000 Driver Development Kit (DDK).

This method is intended to be called by an application or an Active Input Method Editor (IME) without generating any IME-related messages. Therefore, an Active IME generates no IME-related messages in this method.

Requirements

See also

IActiveIME