SetUserGeoID, fonction (winnls.h)
[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
Prise en charge des langues nationales