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).

[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

Voir aussi

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales

Windows.Globalization