SetUserGeoID, fonction (winnls.h)

  • Article

[SetUserGeoID est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt SetUserGeoName.

]

Définit l’identificateur d’emplacement géographique de l’utilisateur. Cet identificateur doit avoir l’une des valeurs décrites dans Table des emplacements géographiques.

Syntaxe

BOOL SetUserGeoID(
  [in] GEOID GeoId
);

Paramètres

[in] GeoId

Identificateur de l’emplacement géographique de l’utilisateur.

Valeur retournée

Retourne TRUE en cas de réussite ou FALSE dans le cas contraire.

Windows XP, Windows Server 2003 : cette fonction ne fournit pas d’informations étendues sur les erreurs. Par conséquent, il n’est pas approprié qu’une application appelle GetLastError après cette fonction. Si l’application appelle GetLastError, elle peut retourner une valeur définie par une fonction précédemment appelée.

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

  • 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. L’une des valeurs 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 exécutées par l’utilisateur. En règle générale, l’application doit appeler cette fonction uniquement lorsque l’utilisateur a explicitement demandé des modifications, mais pas pour des raisons purement spécifiques à l’application.

SetUserGeoID est destiné à être utilisé par les applications conçues pour modifier les paramètres utilisateur, telles que l’application Paramètres Windows. D’autres applications ne doivent pas appeler cette fonction.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [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

Tableau des zones géographiques