ImmGetGuideLine

機能
IMEエラーに関する情報を取得する
Declare Function ImmGetGuideLine Lib "imm32.dll" Alias "ImmGetGuideLineA" _
(ByVal hIMC As Long, ByVal dwIndex As Long, _
ByVal lpBuf As String, ByVal dwBufLen As Long) As Long
Declare Function ImmGetGuideLine Lib "imm32.dll" Alias "ImmGetGuideLineA" _
(ByVal hIMC As Integer, ByVal dwIndex As Integer, _
ByVal lpBuf As String, ByVal dwBufLen As Integer) As Integer

DWORD ImmGetGuideLine(
HIMC hIMC,
DWORD dwIndex,
LPTSTR lpBuf,
DWORD dwBufLen
);
引数
hIMC

入力コンテキストのハンドル(ImmGetContext()関数の戻り値)
dwIndex
取得する情報を指定する定数
lpBuf
(戻り値)データを受け取るバッファ
dwBufLen
同、バイト数
戻り値
dwIndexの設定に応じて定数の一つ
備考
この関数は通常、IMN_GUIDLINEを受け取ったときに呼び出す
戻り値の定数

[dwIndexがGCL_LEVELのとき]
GL_LEVEL_ERROR = &H2                          IMEを持続できないエラー
GL_LEVEL_FATAL = &H1                          致命的なエラー
GL_LEVEL_INFORMATION = &H4                    エラー情報を取得できるエラー
GL_LEVEL_NOGUIDELINE = &H0                    直前のエラーメッセージを解除
GL_LEVEL_WARNIG = &H3                         予期しないエラーだが、IMEを持続可能

[dwIndexがGCL_INDEXのとき]
GL_ID_CANNOTSAVE = &H11                       辞書を保管できない
GL_ID_NOCONVER = &H20                         変換できない
GL_ID_NODICTIONARY = &H10                     辞書がない or 正しい書式ではない
GL_ID_READINGCONFLICT = &H23                  読みが不正
GL_ID_TOOMANYSTROKE = &H22                    画数が多すぎる
GL_ID_TYPEINGERROR = &H21                     入力エラー
GL_ID_UNKNOWN = &H0                           不明なエラー
GL_ID_INPUTERADIN = &H24                      読みの入力を受け取った
GL_ID_INPUTTRADICAL = &H25                    語根の入力を受け取った
GL_ID_CHOOSECANDIDATE = &H28                  候補文字の選択を受け取った
GL_ID_REVERSECONVERSION = &H29                逆変換に関する情報を取得可能

[dwIndexがGCL_STRINGのとき]
            lpBufにコピーしたバイト数
[dwIndexがGCL_PRIVATEのとき]
            lpBufにコピーしたバイト数
dwBufLenに0を設定した場合、バッファに必要なバイト数が戻る