SetUserGeoID-Funktion (winnls.h)

[SetUserGeoID steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen SetUserGeoName.

]

Legt den geografischen Standortbezeichner für den Benutzer fest. Dieser Bezeichner sollte einen der werte aufweisen, die in "Tabelle der geografischen Standorte" beschrieben sind.

Syntax

BOOL SetUserGeoID(
  [in] GEOID GeoId
);

Die Parameter

[in] GeoId

Bezeichner für den geografischen Standort des Benutzers.

Rückgabewert

Gibt WAHR zurück, wenn erfolgreich oder FALSCH andernfalls.

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

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

• 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. Ungültige Parameterwerte.

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

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

Anforderungen

Siehe auch

GetUserGeoID

Funktionen

SetUserGeoName

Tabelle der geografischen Standorte