SetUserGeoName-Funktion (winnls.h)
Legt den geografischen Standort für den aktuellen Benutzer auf den angegebenen Code der Internationalen Organisation für Normung (ISO) 3166-1 oder den numerischen Code der Vereinten Nationen (UN) Serie M, Nummer 49 (M.49) fest.
Syntax
BOOL SetUserGeoName(
[in] PWSTR geoName
);
Parameter
[in] geoName
Der zwei buchstabenige ISO 3166-1- oder numerische UN M.49-Code für den geografischen Standort, der für den aktuellen Benutzer festgelegt werden soll. Rufen Sie EnumSystemGeoNames auf, um die codes abzurufen, die auf dem Betriebssystem verfügbar sind.
Rückgabewert
Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE .
Wenn diese Funktion nicht erfolgreich ist, rufen Sie GetLastError auf, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Gruppenrichtlinie des Computers oder des Benutzers hat diesen Vorgang verboten. |
|
In der Funktion ist ein unerwarteter Fehler aufgetreten. |
|
Ein Parameterwert war ungültig. |
Hinweise
Diese Funktion schreibt den geografischen Standort für einen bestimmten Benutzer anstelle einer bestimmten Anwendung in die Registrierung. Diese Aktion wirkt sich auf das Verhalten anderer Anwendungen aus, die der Benutzer ausführt. Rufen Sie diese Funktion in der Regel nur auf, wenn der Benutzer Explizit Änderungen angefordert hat, aber nicht aus rein anwendungsspezifischen Gründen.
Informationen zu iso 3166-1-Codes mit zwei Buchstaben finden Sie unter Ländercodes – ISO 3166. Informationen zu numerischen UN M.49-Codes finden Sie unter Standardland- oder Gebietscodes für statistische Verwendung (M49).
SetUserGeoName ist für die Verwendung durch Anwendungen vorgesehen, die zum Ändern von Benutzereinstellungen konzipiert sind, z. B. die Windows-Einstellungs-App. Andere Anwendungen sollten diese Funktion nicht aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1709 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winnls.h (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |
Siehe auch
Unterstützung für nationale Sprachen