VerLanguageNameA, fonction (winver.h)
Récupère une chaîne de description pour la langue associée à un identificateur de langue Microsoft binaire 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 par szLang .
Valeur de retour
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 supérieure à 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 égale à zéro. Les identificateurs de langue inconnus ne produisent pas d’erreurs.
Remarques
Cette fonction fonctionne sur les images de fichier 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 continuer en cas de conflit de langue.
Note
L’en-tête winver.h définit VerLanguageName 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 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winver.h (inclure Windows.h) |
| bibliothèque | Version.lib |
| DLL | Api-ms-win-core-localization-l1-2-1.dll |