Fonction SetUserGeoName (winnls.h)

  • Article

Définit l’emplacement géographique de l’utilisateur actuel avec le code 3166-1 de l’Organisation internationale de normalisation (ISO) à deux lettres spécifié ou le code numérique série M, numéro 49 (M.49) de l’Organisation internationale de normalisation (ONU).

Syntaxe

BOOL SetUserGeoName(
  [in] PWSTR geoName
);

Paramètres

[in] geoName

Code ISO 3166-1 à deux lettres ou code UN M.49 numérique pour l’emplacement géographique à définir pour l’utilisateur actuel. Pour obtenir les codes disponibles sur le système d’exploitation, appelez EnumSystemGeoNames.

Valeur retournée

Retourne TRUE si elle réussit ou FALSE dans le cas contraire.

Si cette fonction échoue, appelez GetLastError, qui peut retourner l’un des codes d’erreur suivants :

Code de retour Description
ERROR_ACCESS_DISABLED_BY_POLICY
 La stratégie de groupe de l’ordinateur ou de l’utilisateur a interdit cette opération.
ERROR_INTERNAL_ERROR
 Une erreur inattendue s’est produite dans la fonction.
ERROR_INVALID_PARAMETER
 Une valeur de paramètre n’était pas valide.

Remarques

Cette fonction écrit dans le Registre l’emplacement géographique d’un utilisateur particulier au lieu d’une application particulière. Cette action affecte le comportement d’autres applications que l’utilisateur exécute. En règle générale, appelez cette fonction uniquement lorsque l’utilisateur a explicitement demandé des modifications, mais pas pour des raisons purement spécifiques à l’application.

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

SetUserGeoName est destiné aux applications conçues pour modifier les paramètres utilisateur, telles que l’application Paramètres Windows. Les autres applications ne doivent pas appeler cette fonction.

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

EnumSystemGeoNames

GetUserDefaultGeoName

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales

SetUserGeoID