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