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

Voir aussi

Vue d’ensemble des informations de version