ResolveLocaleName, fonction (winnls.h)

Recherche une correspondance de nom de paramètres régionaux possible pour le nom fourni.

Syntaxe

int ResolveLocaleName(
  [in, optional]  LPCWSTR lpNameToResolve,
  [out, optional] LPWSTR  lpLocaleName,
  [in]            int     cchLocaleName
);

Paramètres

[in, optional] lpNameToResolve

Pointeur vers un nom à résoudre, par exemple, « en-XA » pour l’anglais (usage privé).

[out, optional] lpLocaleName

Pointeur vers une mémoire tampon dans laquelle cette fonction récupère le nom des paramètres régionaux correspondant au nom d’entrée. Par exemple, la correspondance pour le nom « en-XA » est « en-US » pour l’anglais (États-Unis).

Note Si la fonction échoue, l’état de la mémoire tampon de sortie n’est pas garanti pour être précis. Dans ce cas, l’application doit case activée la valeur de retour et les status d’erreur définies par la fonction pour déterminer le cours d’action correct.

 

[in] cchLocaleName

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

Valeur retournée

Retourne la taille de la mémoire tampon contenant le nom des paramètres régionaux, y compris le caractère null de fin, en cas de réussite.

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 assez grande ou elle a été incorrectement définie sur NULL.

Remarques

Le nom des paramètres régionaux récupérés indique un paramètre régional spécifique, y compris la langue et le pays/région, même si la langue d’entrée est neutre. Par exemple, une entrée « en » pour l’anglais (États-Unis) entraîne la récupération de la fonction « en-US ».

Cette fonction peut récupérer des données à partir de paramètres régionaux personnalisés. Il n’est pas garanti que les données soient identiques d’un ordinateur à l’autre ou entre les exécutions d’une application, et le retour d’un paramètre régional valide ne garantit pas qu’elles seront valides sur un autre ordinateur. Si votre application doit conserver ou transmettre des données, consultez Utilisation des données de paramètres régionaux persistants.

À partir de Windows 8 : Les balises de langue obtenues à partir de l’espace de noms Windows.Globalization doivent être converties par ResolveLocaleName avant de pouvoir être utilisées avec n’importe quelle fonction de prise en charge des langues nationales.

Configuration requise

Client minimal pris en charge	Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [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

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales

Windows.Globalization