Overview
Group
Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
imm32.lib
Header File
imm.h
Unicode
WinNT
Platform Notes
None

ImmGetGuideLine

[Now Supported on Windows NT]

The ImmGetGuideLine function gets information about errors. Applications use the information to notify users.

DWORD ImmGetGuideLine(dwBufLen

HIMC hIMC,

DWORD dwIndex,

LPTSTR lpBuf,

DWORD dwBufLen

);

Parameters

hIMC

Handle to the input context.

dwIndex

Type of guideline information to retrieve. Can be one of the following values:

Value
Meaning
GGL_LEVEL
Returns the error level.
GGL_INDEX
Returns the error index.
GGL_STRING
Retrieves the error message string.
GGL_PRIVATE
Returns information about reverse conversion.

lpBuf

Pointer to the buffer that receives the error message string. This parameter can be NULL if dwIndex is not GGL_STRING or GGL_PRIVATE if dwBufLen is zero.

dwBufLen

Size, in bytes, of the buffer pointed to by lpBuf. If zero, the function returns the buffer size needed to receive the error message string, not including the terminating null character.

Return Values

The return value is an error level, an error index, or the size of an error message string, depending on the value of the dwIndex parameter. If dwIndex is GGL_LEVEL, the return value is one of the following:

Value
Meaning
GL_LEVEL_ERROR
Error. The IME may not be able to continue.
GL_LEVEL_FATAL
Fatal error. The IME cannot continue, and data may be lost.
GL_LEVEL_INFORMATION
No error, but information is available for the user.
GL_LEVEL_NOGUIDELINE
No error. Remove previous error message if still visible.
GL_LEVEL_WARNING
Unexpected input or other result. The user should be warned, but the IME can continue.

If dwIndex is GGL_INDEX, the return value is one of the following:

Value
Meaning
GL_ID_CANNOTSAVE
The dictionary or the statistics data cannot be saved.
GL_ID_NOCONVERT
The IME cannot convert any more.
GL_ID_NODICTIONARY
The IME cannot find the dictionary, or the dictionary has an unexpected format.
GL_ID_NOMODULE
The IME can not find the module that IME needs.
GL_ID_READINGCONFLICT
For example, some vowels cannot put together.
GL_ID_TOOMANYSTROKE
There are too many strokes for one character or one clause.
GL_ID_TYPINGERROR
Typing error. The IME can not handle this typing.
GL_ID_UNKNOWN
Unknown error. The application should refer to the error message string.
GL_ID_INPUTREADING
IME accepts reading character input.
GL_ID_INPUTRADICAL
IME accepts radical character input.
GL_ID_INPUTCODE
IME accepts character code input.
GL_ID_CHOOSECANDIDATE
IME accepts candidate string selection.
GL_ID_REVERSECONVERSION
Information about reverse conversion is available.

If dwIndex is GGL_STRING, the return value is the number of bytes of the string copied to the buffer, or if dwBufLen is zero, the return value is the buffer size needed to receive the string.

If dwIndex is GGL_PRIVATE, the return value is the number of bytes of information copied to the buffer. If dwIndex is GGL_PRIVATE and dwBufLen is zero, the return value is the buffer size needed to receive the information.

Remarks

Applications typically call this function after receiving an IMN_GUIDELINE message.

Software for developers
Delphi Components
.Net Components
Software for Android Developers
More information resources
MegaDetailed.Net
Unix Manual Pages
Delphi Examples
Databases for Amazon shops developers
Amazon Categories Database
Browse Nodes Database