SetUserGeoName-Funktion (winnls.h)

Artikel
03/06/2024

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
ERROR_ACCESS_DISABLED_BY_POLICY	Die Gruppenrichtlinie des Computers oder des Benutzers hat diesen Vorgang verboten.
ERROR_INTERNAL_ERROR	In der Funktion ist ein unerwarteter Fehler aufgetreten.
ERROR_INVALID_PARAMETER	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