Freigeben über


SetUserGeoName-Funktion (winnls.h)

Legt den geografischen Standort für den aktuellen Benutzer auf den angegebenen zwei buchstabenigen International Organization for Standardization (ISO) 3166-1-Code oder den numerischen UN-Code (United Nations) Series M, Number 49 (M.49) fest.

Syntax

BOOL SetUserGeoName(
  [in] PWSTR geoName
);

Die 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 WAHR zurück, wenn erfolgreich oder FALSCH andernfalls.

Wenn diese Funktion nicht erfolgreich ist, rufen Sie GetLastError auf, wodurch eine der folgenden Fehlercodes zurückgegeben werden kann:

Rückgabecode Description
ERROR_ACCESS_DISABLED_BY_POLICY
Die Gruppenrichtlinie des Computers oder der Benutzer hat diesen Vorgang verboten.
ERROR_INTERNAL_ERROR
Unerwarteter Fehler in der Funktion.
ERROR_INVALID_PARAMETER
Ein Parameterwert war ungültig.

Bemerkungen

Diese Funktion schreibt in die Registrierung den geografischen Standort für einen bestimmten Benutzer anstelle einer bestimmten Anwendung. 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 aus zwei Buchstaben finden Sie unter Ländercodes – ISO 3166. Informationen zu numerischen UN-M.49-Codes finden Sie unter Standardland- oder Ortsvorwahlen für die statistische Verwendung (M49).

SetUserGeoName ist für die Verwendung durch Anwendungen vorgesehen, die zum Ändern von Benutzereinstellungen konzipiert sind, z. B. in den Windows-Einstellungen. Andere Anwendungen sollten diese Funktion nicht aufrufen.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 10, Version 1709 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2016 [nur Desktop-Apps]
Zielplattform Fenster
Header winnls.h (enthalten Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

Siehe auch

EnumSystemGeoNames

GetUserDefaultGeoName

Funktionen

SetUserGeoID