ImmGetIMEFileName

This function gets the file name of the IME associated with the specified keyboard layout.

At a Glance

Header file: Imm.h
Windows CE versions: 2.10 and later

Syntax

BOOL ImmGetIMEFileName( HKL hKL, LPTSTR lpszFileName,
UINT uBufLen );

Parameters

hKL

[in] Handle to the keyboard layout. Windows CE does not support keyboard layouts; however, hKL is used in this instance to distinguish between locale-specific IMEs.

lpszFileName

[out] Long pointer to the buffer that receives the file name.

uBufLen

[in] Specifies the size, in bytes, of the buffer. If zero, the function returns the buffer size in bytes needed to receive the file name, not including the terminating null character.

Return Values

The number of bytes in the file name copied to the buffer, or, if uBufLen is zero, the buffer size needed for the file name indicates success. In either case, the terminating null character is not included.

Remarks

In the registry, the system stores the file name as the IME name value in HKEY_LOCAL_MACHINE root under the \System\CurrentControlSet\Control\Layout\hKL key.