SetUserGeoID-Funktion (winnls.h)
[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
Unterstützung für landessprachliche Sprachen