LCIDToLocaleName, fonction (winnls.h)

Convertit un identificateur de paramètres régionaux en nom de paramètres régionaux.

Note Pour les paramètres régionaux personnalisés, y compris ceux créés par Microsoft, vos applications doivent préférer les noms de paramètres régionaux aux identificateurs régionaux.

 

Syntaxe

int LCIDToLocaleName(
  [in]            LCID   Locale,
  [out, optional] LPWSTR lpName,
  [in]            int    cchName,
  [in]            DWORD  dwFlags
);

Paramètres

[in] Locale

Identificateur de paramètres régionaux à traduire. Vous pouvez utiliser la macro MAKELCID pour créer un identificateur de paramètres régionaux ou utiliser l’une des valeurs prédéfinies suivantes.

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

Windows Vista : Les identificateurs de paramètres régionaux personnalisés suivants sont également pris en charge.

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

[out, optional] lpName

Pointeur vers une mémoire tampon dans laquelle cette fonction récupère le nom des paramètres régionaux ou l’une des valeurs prédéfinies suivantes.

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

[in] cchName

Taille, en caractères, de la mémoire tampon du nom des paramètres régionaux. La longueur maximale possible d’un nom de paramètres régionaux, y compris un caractère null de fin, est LOCALE_NAME_MAX_LENGTH. Il s’agit de la taille recommandée à fournir pour ce paramètre.

L’application peut également définir ce paramètre sur 0. Dans ce cas, la fonction retourne la taille requise pour la mémoire tampon du nom des paramètres régionaux.

[in] dwFlags

Avant Windows 7 : Réservés au; doit toujours être 0.

À compter de Windows 7 : Peut être défini sur LOCALE_ALLOW_NEUTRAL_NAMES pour autoriser le retour d’un nom neutre.

Valeur retournée

Retourne le nombre de caractères, y compris le caractère null de fin, dans le nom des paramètres régionaux en cas de réussite. Si la fonction réussit et que la valeur de cchName est 0, la valeur de retour est la taille requise, en caractères (y compris les valeurs null), pour la mémoire tampon de nom de paramètres régionaux.

La fonction retourne 0 si elle ne réussit pas. Pour obtenir des informations d’erreur étendues, l’application peut appeler GetLastError, qui peut retourner l’un des codes d’erreur suivants :

• ERROR_INSUFFICIENT_BUFFER. Une taille de mémoire tampon fournie n’était pas suffisamment grande ou a été incorrectement définie sur NULL.
• ERROR_INVALID_PARAMETER. L’une des valeurs de paramètre n’était pas valide.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible	Windows
En-tête	winnls.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

LocaleNameToLCID

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales