Partager via

GetUserDefaultGeoName, fonction (winnls.h)

  • Article

Récupère l’emplacement géographique par défaut de l’utilisateur en tant qu’organisation internationale de normalisation (ISO) 3166-1 code à deux lettres, le cas échéant. Dans le cas contraire, un code numérique de la série DES Nations Unies (ONU), numéro 49 (M.49).

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 numérique 3166-1 à deux lettres de l’Organisation internationale de normalisation (ISO) 3166-1 ou un code numérique de série ONU (ONU), numéro 49 (M.49).

[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 de retour

Le nombre de caractères que la fonction copie 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ées dans la mémoire tampon que le paramètre geoName spécifie.

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 :

Retourner le code 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

Si le code ISO 3166-1 de l’emplacement géographique par défaut de l’utilisateur est « XX » (indiquant qu’aucun code n’a été affecté), mais que l’emplacement a un code UN M.49 affecté, le code M.49 est retourné sous forme de chaîne décimale.

Si le code ISO 3166-1 de l’emplacement géographique par défaut de l’utilisateur est « XX » (ce qui indique qu’aucun code n’a été affecté), mais que l’emplacement a un code UN M.49 affecté, le code M.49 est retourné sous forme de chaîne décimale.

Pour plus d’informations sur les codes ISO 3166-1 à deux lettres, consultez codes de pays ISO 3166.

Pour plus d’informations sur les codes NUMÉRIQUES UN M.49, consultez codes de pays ou de zones standard pour une utilisation statistique (M49).

Exigences

Exigence Valeur
client minimum pris en charge Windows 10, version 1709 [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2016 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête winnls.h (include Windows.h)
bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi