ImmGetIMEFileNameA, fonction (imm.h)

Article
11/20/2024

Récupère le nom de fichier de l’IME associé aux paramètres régionaux d’entrée spécifiés.

Syntaxe

UINT ImmGetIMEFileNameA(
                  HKL   unnamedParam1,
  [out, optional] LPSTR lpszFileName,
  [in]            UINT  uBufLen
);

Paramètres

unnamedParam1

[out, optional] lpszFileName

Pointeur vers une mémoire tampon dans laquelle la fonction récupère le nom du fichier. Ce paramètre contient NULL lorsque uBufLen est défini sur NULL.

[in] uBufLen

Taille, en octets, de la mémoire tampon de sortie. L’application spécifie 0 si la fonction doit retourner la taille de la mémoire tampon nécessaire pour recevoir le nom de fichier, sans inclure le caractère null de fin. Pour Unicode, uBufLen spécifie la taille dans les caractères Unicode, sans inclure le caractère null de fin.

Valeur de retour

Retourne le nombre d’octets du nom de fichier copié dans la mémoire tampon de sortie. Si l’application définit uBufLen sur 0, la fonction retourne la taille de la mémoire tampon requise pour le nom de fichier. Dans les deux cas, le caractère null de fin n’est pas inclus.

Pour Unicode, la fonction retourne le nombre de caractères Unicode copiés dans la mémoire tampon de sortie, sans inclure le caractère Null de fin Unicode.

Remarques

Dans le Registre, le système d’exploitation stocke le nom de fichier en tant que « valeur de nom IME » dans la clé de Registre HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Keyboard Layouts\HKL.

Note

L’en-tête imm.h définit ImmGetIMEFileName comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement], prise en charge linguistique de l’Asie de l’Est installée.
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	imm.h (include Immdev.h, Windows.h)
bibliothèque	Imm32.lib
DLL	Imm32.dll

Voir aussi

du gestionnaire de méthodes d’entrée

fonctions Input Method Manager

Partager via