ImmGetGuideLine

【勇芳软件工作室】汉化HomePreviousNext

[Now Supported on Windows NT]

ImmGetGuideLine函数获取有关错误的信息。应用程序使用该信息通知用户。

DWORD ImmGetGuideLine（【dwBufLen】

HIMC 【hIMC】, 
DWORD 【dwIndex】, 
LPTSTR 【lpBufmt】, 
DWORD 【dwBufLen】 
); 

参数

【hIMC】

处理输入上下文。

【dwIndex】

要检索的指南信息类型。可以是以下值之一：

值含义
GGL_LEVEL返回错误级别。
GGL_INDEX返回错误索引。
GGL_STRING检索错误消息字符串。
GGL_PRIVATE返回有关反向转换的信息。

【lpBufmt】

指向接收错误消息字符串的缓冲区的指针。如果【dwIndex】不为GGL_STRING或GGL_PRIVATE，则【dwBufLen】为零，则此参数可以为NULL。

【dwBufLen】

【lpBuf。mt】指向的缓冲区的大小（以字节为单位）如果为零，则该函数返回接收错误消息字符串所需的缓冲区大小，不包括终止空字符。

返回值

取决于【dwIndex】参数的值，返回值是错误级别，错误索引或错误消息字符串的大小。如果【dwIndex】为GGL_LEVEL，则返回值为以下之一：

值含义
GL_LEVEL_ERROR错误。IME可能无法继续。
GL_LEVEL_FATAL致命错误。IME无法继续，数据可能会丢失。
GL_LEVEL_INFORMATION没有错误，但信息可供用户使用。
GL_LEVEL_NOGUIDELINE没有错误。如果仍然可见，请删除以前的错误消息。
GL_LEVEL_WARNING意外输入或其他结果。应该警告用户，但IME可以继续。

如果【dwIndex】为GGL_INDEX，则返回值为以下之一：

值含义
GL_ID_CANNOTSAVE字典或统计数据无法保存。
GL_ID_NOCONVERTIME不能转换。
GL_ID_NODICTIONARYIME找不到字典，或字典有意想不到的格式。
GL_ID_NOMODULEIME找不到IME需要的模块。
GL_ID_READINGCONFLICT例如，一些元音不能放在一起。
GL_ID_TOOMANYSTROKE一个字符或一个子句的笔画太多了。
GL_ID_TYPINGERROR输入错误。IME无法处理此类型。
GL_ID_UNKNOWN未知错误。应用程序应该引用错误消息字符串。
GL_ID_INPUTREADINGIME接受阅读字符输入。
GL_ID_INPUTRADICALIME接受激进的字符输入。
GL_ID_INPUTCODEIME接受字符代码输入。
GL_ID_CHOOSECANDIDATEIME接受候选字符串选择。
GL_ID_REVERSECONVERSION有关反向转换的信息可用。

如果【dwIndex】是GGL_STRING，则返回值是复制到缓冲区的字符串数，或者如果【dwBufLen】为零，则返回值是接收字符串所需的缓冲区大小。

如果【dwIndex】是GGL_PRIVATE，则返回值是复制到缓冲区的信息的字节数。如果【dwIndex】为GGL_PRIVATE且【dwBufLen】为零，则返回值是接收信息所需的缓冲区大小。

备注

应用程序通常在收到IMN_GUIDELINE消息后调用此函数。