GetUserDefaultGeoName, fonction (winnls.h)

  • Article

Récupère le code 3166-1 à deux lettres de l’Organisation internationale de normalisation (ISO) ou le code numérique de la série M, numéro 49 (M.49) de l’organisation des Nations Unies (UN) pour l’emplacement géographique par défaut de l’utilisateur.

Syntaxe

int GetUserDefaultGeoName(
  [out] LPWSTR geoName,
  [in]  int    geoNameCount
);

Paramètres

[out] geoName

Pointeur vers une mémoire tampon dans laquelle cette fonction doit écrire le code ISO 3166-1 à deux lettres terminé par null ou le code UN M.49 numérique pour l’emplacement géographique par défaut de l’utilisateur.

[in] geoNameCount

Taille de la mémoire tampon spécifiée par le paramètre geoName . Si cette valeur est égale à zéro, la fonction retourne uniquement le nombre de caractères que la fonction copierait dans la mémoire tampon de sortie, mais n’écrit pas le nom de l’emplacement géographique par défaut de l’utilisateur dans la mémoire tampon.

Valeur retournée

Nombre de caractères que la fonction copierait dans la mémoire tampon de sortie, si la valeur du paramètre geoNameCount est égale à zéro. Sinon, le nombre de caractères que la fonction a copiés dans la mémoire tampon spécifiée par le paramètre geoName .

Zéro indique que la fonction a échoué. Pour obtenir des informations d’erreur étendues, appelez GetLastError, qui peut retourner l’un des codes d’erreur suivants :

Code de retour Description
ERROR_INVALID_PARAMETER
 Une valeur de paramètre n’était pas valide.
ERROR_BADDB
 La fonction n’a pas pu lire les informations du Registre.
ERROR_INSUFFICIENT_BUFFER
 La mémoire tampon spécifiée par le paramètre geoName est trop petite pour la chaîne.

Remarques

Pour plus d’informations sur les codes ISO 3166-1 à deux lettres, consultez Codes pays - ISO 3166. Pour plus d’informations sur les codes numériques UN M.49, consultez Codes de pays ou de zone standard à usage statistique (M49).

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
Plateforme cible Windows
En-tête winnls.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

GetUserGeoID

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales

SetUserGeoName