SetUserGeoID-Funktion (winnls.h)

  • Artikel

[SetUserGeoID ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen SetUserGeoName.

]

Legt den geografischen Standortbezeichner für den Benutzer fest. Dieser Bezeichner sollte einen der in Tabelle der geografischen Standorte beschriebenen Werte aufweisen.

Syntax

BOOL SetUserGeoID(
  [in] GEOID GeoId
);

Parameter

[in] GeoId

Bezeichner für den geografischen Standort des Benutzers.

Rückgabewert

Gibt TRUE zurück, wenn dies erfolgreich war, oder andernfalls FALSE .

Windows XP, Windows Server 2003: Diese Funktion liefert keine erweiterten Fehlerinformationen. Daher ist es nicht angebracht, dass eine Anwendung GetLastError nach dieser Funktion aufruft. Wenn die Anwendung GetLastError aufruft, kann sie einen Wert zurückgeben, der von einer zuvor aufgerufenen Funktion festgelegt wurde.

Wenn diese Funktion nicht erfolgreich ist, kann die Anwendung GetLastError aufrufen, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:

  • 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. Jeder der Parameterwerte 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 vom Benutzer ausgeführt werden. In der Regel sollte die Anwendung diese Funktion nur aufrufen, wenn der Benutzer explizit Änderungen angefordert hat, jedoch nicht aus rein anwendungsspezifischen Gründen.

SetUserGeoID ist für die Verwendung durch Anwendungen vorgesehen, die zum Ändern von Benutzereinstellungen entwickelt wurden, z. B. die Windows-Einstellungs-App. Andere Anwendungen sollten diese Funktion nicht aufrufen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winnls.h (windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

GetUserGeoID

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen

SetUserGeoName

Tabelle der geografischen Standorte