GetUserDefaultLocaleName, fonction (winnls.h)

  • Article

Récupère le nom des paramètres régionaux par défaut de l’utilisateur.

Note L’application doit appeler cette fonction de préférence à GetUserDefaultLCID si elle est conçue pour s’exécuter uniquement sur Windows Vista et versions ultérieures.

 

Syntaxe

int GetUserDefaultLocaleName(
  [out] LPWSTR lpLocaleName,
  [in]  int    cchLocaleName
);

Paramètres

[out] lpLocaleName

Pointeur vers une mémoire tampon dans laquelle cette fonction récupère le nom des paramètres régionaux.

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

Note Sur les systèmes mono-utilisateur, la valeur de retour est la même que celle retournée par GetSystemDefaultLocaleName.

 

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.

Remarques

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. Si votre application doit conserver ou transmettre des données, consultez Utilisation des données de paramètres régionaux persistants.

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

GetLocaleInfoEx

GetSystemDefaultLocaleName

GetUserDefaultLCID

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales