Función ImmGetGuideLineA (imm.h)
Recupera información sobre los errores. Las aplicaciones usan la información para las notificaciones de usuario.
Sintaxis
DWORD ImmGetGuideLineA(
[in] HIMC unnamedParam1,
[in] DWORD dwIndex,
[out, optional] LPSTR lpBuf,
[in] DWORD dwBufLen
);
Parámetros
[in] unnamedParam1
Controle el contexto de entrada.
[in] dwIndex
Tipo de información de instrucciones que se va a recuperar. Este parámetro puede tener uno de los siguientes valores.
[out, optional] lpBuf
Puntero a un búfer en el que la función recupera la cadena del mensaje de error. Este parámetro contiene NULL si dwIndex no es GGL_STRING ni GGL_PRIVATE o si dwBufLen está establecido en 0.
[in] dwBufLen
Tamaño, en bytes, del búfer de salida. La aplicación establece este parámetro en 0 si la función devuelve el tamaño del búfer necesario para recibir la cadena del mensaje de error, no incluido el carácter nulo de terminación.
Valor devuelto
Devuelve un nivel de error, un índice de error o el tamaño de una cadena de mensaje de error, según el valor del parámetro dwIndex. Si dwIndex es GGL_LEVEL, el valor devuelto es uno de los siguientes valores.
| Valor | Significado |
|---|---|
| GL_LEVEL_ERROR | Error. Es posible que el IME no pueda continuar. |
| GL_LEVEL_FATAL | Error irrecuperable. El IME no puede continuar y es posible que se pierdan los datos. |
| GL_LEVEL_INFORMATION | No hay ningún error. La información está disponible para el usuario. |
| GL_LEVEL_NOGUIDELINE | No hay ningún error. Quite el mensaje de error anterior si sigue visible. |
| GL_LEVEL_WARNING | Entrada inesperada u otro resultado. Se debe advertir al usuario, pero el IME puede continuar. |
Si dwIndex es GGL_INDEX, el valor devuelto es uno de los valores siguientes.
| Valor | Significado |
|---|---|
| GL_ID_CANNOTSAVE | El diccionario o los datos de estadísticas no se pueden guardar. |
| GL_ID_NOCONVERT | El IME no puede convertir más. |
| GL_ID_NODICTIONARY | El IME no encuentra el diccionario o el diccionario tiene un formato inesperado. |
| GL_ID_NOMODULE | El IME no encuentra el módulo necesario. |
| GL_ID_READINGCONFLICT | Se produjo un conflicto de lectura. Por ejemplo, algunas vocales no se pueden juntar para formar un carácter. |
| GL_ID_TOOMANYSTROKE | Hay demasiados trazos para un carácter o una cláusula. |
| GL_ID_TYPINGERROR | Error al escribir. El IME no puede controlar esta escritura. |
| GL_ID_UNKNOWN | Error desconocido. Consulte la cadena del mensaje de error. |
| GL_ID_INPUTREADING | El IME acepta la entrada de caracteres de lectura del usuario final. |
| GL_ID_INPUTRADICAL | El IME acepta la entrada de caracteres radical del usuario final. |
| GL_ID_INPUTCODE | El IME acepta la entrada de código de caracteres del usuario final. |
| GL_ID_CHOOSECANDIDATE | El IME acepta la selección de cadenas candidatas del usuario final. |
| GL_ID_REVERSECONVERSION | La información sobre la conversión inversa está disponible llamando a ImmGetGuideLine, especificando GGL_PRIVATE. La información recuperada está en formato CANDIDATELIST. |
Si dwIndex es GGL_STRING, el valor devuelto es el número de bytes de la cadena copiada en el búfer. Sin embargo, si dwBufLen es 0, el valor devuelto es el tamaño de búfer necesario para recibir la cadena, no incluido el carácter nulo de terminación. Para Unicode, si dwBufLen es 0, el valor devuelto es el tamaño, en bytes que no incluyen el carácter NULL de terminación Unicode.
Si dwIndex es GGL_PRIVATE, el valor devuelto es el número de bytes de información copiada en el búfer. Si dwIndex es GGL_PRIVATE y dwBufLen es 0, el valor devuelto es el tamaño de búfer necesario para recibir la información.
Observaciones
Las aplicaciones suelen llamar a esta función después de recibir un comando IMN_GUIDELINE.
Nota
El encabezado imm.h define ImmGetGuideLine como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP [solo aplicaciones de escritorio],compatibilidad con idiomas del Este asiático instaladas. |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
imm.h (incluya Immdev.h, Windows.h) |
| biblioteca de |
Imm32.lib |
| DLL de |
Imm32.dll |
Consulte también
del Administrador de métodos de entrada de