IActiveIME::ToAsciiEx Method

---

Generates a conversion result through the Active Input Method Editor (IME) conversion engine according to the hIMC parameter.

Syntax

HRESULT ToAsciiEx(
    UINT uVirKey,
    UINT uScanCode,
    BYTE *pbKeyState,
    UINT fuState,
    HIMC hIMC,
    DWORD *pdwTransBuf,
    UINT *puSize
);

Parameters

uVirKey

[in] Unsigned integer value that specifies the virtual key code to be translated.

uScanCode

[in] Unsigned integer value that specifies the hardware scan code of the key to be translated.

pbKeyState

[in] Address of a 256-byte array that contains the current keyboard state. The Active IME should not modify the content of the key state.

fuState

[in] Unsigned integer value that specifies the active menu flag.

hIMC

[in] Handle of the input context.

pdwTransBuf

[out] Address of an unsigned long integer value that receives the translated result.

puSize

[out] Address of an unsigned integer value that receives the number of messages.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

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