ImmGetConversionListW, fonction (imm.h)

Article
08/24/2023

Récupère la liste des résultats de conversion de caractères ou de mots sans générer de messages liés à l’IME.

Syntaxe

DWORD ImmGetConversionListW(
        HKL             unnamedParam1,
        HIMC            unnamedParam2,
  [in]  LPCWSTR         lpSrc,
  [out] LPCANDIDATELIST lpDst,
  [in]  DWORD           dwBufLen,
  [in]  UINT            uFlag
);

Paramètres

unnamedParam1

unnamedParam2

[in] lpSrc

Pointeur vers une chaîne de caractères terminée par un caractère null spécifiant la source de la liste.

[out] lpDst

Pointeur vers une structure CANDIDATELIST dans laquelle la fonction récupère la liste.

[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 requise pour la liste des résultats de conversion complète.

[in] uFlag

Indicateur d’action. Ce paramètre peut avoir l’une des valeurs suivantes.

Valeur	Signification
GCL_CONVERSION	La chaîne source est la chaîne de lecture. La fonction copie la chaîne de résultat dans la mémoire tampon de destination.
GCL_REVERSECONVERSION	La chaîne source est la chaîne de résultat. La fonction copie la chaîne de lecture dans la mémoire tampon de destination.
GCL_REVERSE_LENGTH	La chaîne source est la chaîne de résultat. La fonction retourne la taille, en octets, de la chaîne de lecture créée si GCL_REVERSECONVERSION est spécifié.

Valeur retournée

Retourne le nombre d’octets copiés dans la mémoire tampon de sortie. Si l’application définit le paramètre dwBufLen sur 0, la fonction retourne la taille, en octets, de la mémoire tampon de sortie requise.

Notes

L’en-tête imm.h définit ImmGetConversionList en tant qu’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. La combinaison 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.

Spécifications


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	imm.h (inclure Immdev.h, Windows.h)
Bibliothèque	Imm32.lib
DLL	Imm32.dll

Voir aussi

CANDIDATELIST

Gestionnaire de méthodes d’entrée

Fonctions du gestionnaire de méthodes d’entrée

Partager via