ImmGetGuideLineW, fonction (immdev.h)
Récupère des informations sur les erreurs. Les applications utilisent les informations pour les notifications utilisateur.
Syntaxe
DWORD ImmGetGuideLineW(
[in] HIMC unnamedParam1,
[in] DWORD dwIndex,
[out, optional] LPWSTR lpBuf,
[in] DWORD dwBufLen
);
Paramètres
[in] unnamedParam1
Gérez le contexte d’entrée.
[in] dwIndex
Type d’informations de ligne directrice à récupérer. Ce paramètre peut avoir l’une des valeurs suivantes.
[out, optional] lpBuf
Pointeur vers une mémoire tampon dans laquelle la fonction récupère la chaîne de message d’erreur. Ce paramètre contient NULL si dwIndex n’est pas GGL_STRING ou GGL_PRIVATE ou si dwBufLen a la valeur 0.
[in] dwBufLen
Taille, en octets, de la mémoire tampon de sortie. L’application définit ce paramètre sur 0 si la fonction doit retourner la taille de mémoire tampon nécessaire pour recevoir la chaîne de message d’erreur, sans inclure le caractère null de fin.
Valeur retournée
Retourne un niveau d’erreur, un index d’erreur ou la taille d’une chaîne de message d’erreur, en fonction de la valeur du paramètre dwIndex . Si dwIndex est GGL_LEVEL, le retour est l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
| GL_LEVEL_ERROR | Erreur. L’IME peut ne pas être en mesure de continuer. |
| GL_LEVEL_FATAL | Erreur irrécupérable. L’IME ne peut pas continuer et les données peuvent être perdues. |
| GL_LEVEL_INFORMATION | Pas d'erreur. Des informations sont disponibles pour l’utilisateur. |
| GL_LEVEL_NOGUIDELINE | Pas d'erreur. Supprimez le message d’erreur précédent s’il est toujours visible. |
| GL_LEVEL_WARNING | Entrée inattendue ou autre résultat. L’utilisateur doit être averti, mais l’IME peut continuer. |
Si dwIndex est GGL_INDEX, la valeur de retour est l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
| GL_ID_CANNOTSAVE | Impossible d’enregistrer le dictionnaire ou les données de statistiques. |
| GL_ID_NOCONVERT | L’IME ne peut plus convertir. |
| GL_ID_NODICTIONARY | L’IME ne trouve pas le dictionnaire, ou le dictionnaire a un format inattendu. |
| GL_ID_NOMODULE | L’IME ne trouve pas le module nécessaire. |
| GL_ID_READINGCONFLICT | Un conflit de lecture s’est produit. Par exemple, certaines voyelles ne peuvent pas être réunies pour former un caractère. |
| GL_ID_TOOMANYSTROKE | Il y a trop de traits pour un caractère ou une clause. |
| GL_ID_TYPINGERROR | Erreur de saisie. L’IME ne peut pas gérer ce type de saisie. |
| GL_ID_UNKNOWN | Erreur inconnue. Reportez-vous à la chaîne du message d’erreur. |
| GL_ID_INPUTREADING | L’IME accepte l’entrée de caractères de lecture de l’utilisateur final. |
| GL_ID_INPUTRADICAL | L’IME accepte l’entrée de caractères radicaux de l’utilisateur final. |
| GL_ID_INPUTCODE | L’IME accepte l’entrée de code de caractère de l’utilisateur final. |
| GL_ID_CHOOSECANDIDATE | L’IME accepte la sélection de chaîne candidate de l’utilisateur final. |
| GL_ID_REVERSECONVERSION | Des informations sur la conversion inversée sont disponibles en appelant ImmGetGuideLine, en spécifiant GGL_PRIVATE. Les informations récupérées sont au format CANDIDATELIST . |
Si dwIndex est GGL_STRING, la valeur de retour correspond au nombre d’octets de la chaîne copiée dans la mémoire tampon. Toutefois, si dwBufLen est 0, la valeur de retour correspond à la taille de mémoire tampon nécessaire pour recevoir la chaîne, sans inclure le caractère null de fin. Pour Unicode, si dwBufLen est 0, la valeur renvoyée est la taille, en octets non compris le caractère null de fin Unicode.
Si dwIndex est GGL_PRIVATE, la valeur de retour est le nombre d’octets d’informations copiées dans la mémoire tampon. Si dwIndex est GGL_PRIVATE et que dwBufLen est 0, la valeur de retour correspond à la taille de mémoire tampon nécessaire pour recevoir les informations.
Remarques
Les applications appellent généralement cette fonction après avoir reçu une commande IMN_GUIDELINE .
Notes
L’en-tête immdev.h définit ImmGetGuideLine comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement], prise en charge des langues d’Asie de l’Est installée. |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | immdev.h (inclure Immdev.h, Windows.h) |
| Bibliothèque | Imm32.lib |
| DLL | Imm32.dll |