SetUserGeoID, fonction (winnls.h)

[SetUserGeoID est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Exigences. Il 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 la 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 si la valeur est réussie ou FALSE dans le cas contraire.

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

Si cette fonction ne réussit pas, 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’est 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 demandé explicitement 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, tels que dans les paramètres Windows. Les autres applications ne doivent pas appeler cette fonction.

Spécifications

Voir aussi

GetUserGeoID

prise en charge des langues nationales

fonctions de prise en charge des langues nationales

SetUserGeoName

Table des emplacements géographiques