Fonction VerLanguageNameA (winver.h)
Récupère une chaîne de description pour la langue associée à un identificateur binaire de langue Microsoft spécifié.
Syntaxe
DWORD VerLanguageNameA(
[in] DWORD wLang,
[out] LPSTR szLang,
[in] DWORD cchLang
);
Paramètres
[in] wLang
Type : DWORD
Identificateur de langage binaire. Pour obtenir la liste complète des identificateurs de langue, consultez Identificateurs de langue.
Par exemple, la chaîne de description associée à l’identificateur de langue 0x040A est « Espagnol (tri traditionnel) ». Si l’identificateur est inconnu, le paramètre szLang pointe vers une chaîne par défaut (« Language Neutral »).
[out] szLang
Type : LPTSTR
Langue spécifiée par le paramètre wLang .
[in] cchLang
Type : DWORD
Taille, en caractères, de la mémoire tampon pointée vers szLang.
Valeur retournée
Type : DWORD
La valeur de retour est la taille, en caractères, de la chaîne retournée dans la mémoire tampon. Cette valeur n’inclut pas le caractère null de fin. Si la chaîne de description est inférieure ou égale à la mémoire tampon, la chaîne de description entière se trouve dans la mémoire tampon. Si la chaîne de description est plus grande que la mémoire tampon, la chaîne de description est tronquée à la longueur de la mémoire tampon.
Si une erreur se produit, la valeur de retour est zéro. Les identificateurs de langue inconnue ne produisent pas d’erreurs.
Remarques
Cette fonction fonctionne sur les images de fichiers 16, 32 et 64 bits.
En règle générale, un programme d’installation utilise cette fonction pour traduire un identificateur de langue retourné par la fonction VerQueryValue . La chaîne de texte peut être utilisée dans une boîte de dialogue qui demande à l’utilisateur comment procéder en cas de conflit linguistique.
Notes
L’en-tête winver.h définit VerLanguageName 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 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winver.h (inclure Windows.h) |
| Bibliothèque | Version.lib |
| DLL | Api-ms-win-core-localization-l1-2-1.dll |