ImmGetIMEFileNameA, fonction (imm.h)

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 de 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 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 en caractères Unicode, à l’exception du caractère null de fin.

Valeur retournée

Retourne le nombre d’octets dans le 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.

Notes

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.

Notes

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

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

Gestionnaire de méthodes d’entrée

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