LCIDToLocaleName, fonction (winnls.h)
Convertit un identificateur de paramètres régionaux en nom de paramètres 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.
Windows Vista : Les identificateurs de paramètres régionaux personnalisés suivants sont également pris en charge.[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.
[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 |