SetLocaleInfoA-Funktion (winnls.h)
Legt ein Informationselement im Benutzer außer Kraft, um den Teil des aktuellen Gebietsschemas außer Kraft zu setzen. Diese Funktion legt die Systemstandardwerte nicht fest.
Syntax
BOOL SetLocaleInfoA(
[in] LCID Locale,
[in] LCTYPE LCType,
[in] LPCSTR lpLCData
);
Parameter
[in] Locale
Für die ANSI-Version der Funktion wird der Gebietsschemabezeichner des Gebietsschemas mit der Codeseite verwendet, die beim Interpretieren der lpLCData-Informationen verwendet wird. Für die Unicode-Version wird dieser Parameter ignoriert.
Sie können das MAKELCID-Makro verwenden, um einen Gebietsschemabezeichner zu erstellen oder einen der folgenden vordefinierten Werte zu verwenden.
Die folgenden benutzerdefinierten Gebietsschemabezeichner werden ebenfalls unterstützt.[in] LCType
Typ der gebietsschemainformationen, die festgelegt werden sollen. Gültige Konstanten finden Sie im Abschnitt "Konstanten, die im LCType-Parameter von GetLocaleInfo, GetLocaleInfoEx und SetLocaleInfo" von Locale Information Constants verwendet werden. Die Anwendung kann nur einen Wert pro Aufruf angeben, kann aber den binären OR-Operator verwenden, um LOCALE_USE_CP_ACP mit jeder anderen Konstante zu kombinieren.
[in] lpLCData
Zeiger auf eine null-beendete Zeichenfolge, die die gebietsschemainformationen enthält, die festgelegt werden sollen. Die Informationen müssen im formatspezifisch für die angegebene Konstante sein. Die Anwendung verwendet eine Unicode-Zeichenfolge für die Unicode-Version der Funktion und eine ANSI-Zeichenfolge für die ANSI-Version.
Rückgabewert
Gibt einen Wert ohne Zero zurück, wenn er erfolgreich ist oder 0 andernfalls. Um erweiterte Fehlerinformationen abzurufen, 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_INVALID_ACCESS. Der Zugriffscode war ungültig.
- ERROR_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
- ERROR_INVALID_PARAMETER. Eine der Parameterwerte war ungültig.
Hinweise
Diese Funktion schreibt in die Registrierung, wobei werte festgelegt werden, die einem bestimmten Benutzer zugeordnet sind, anstatt einer bestimmten Anwendung. Diese Registrierungswerte wirken sich auf das Verhalten anderer Anwendungen aus, die vom Benutzer ausgeführt werden. In der Regel sollte eine Anwendung diese Funktion nur aufrufen, wenn der Benutzer die Änderungen explizit angefordert hat. Die Registrierungseinstellungen sollten nicht für den Komfort einer einzelnen Anwendung geändert werden.
Für den LCType-Parameter sollte die Anwendung LOCALE_USE_CP_ACP festlegen, um die ANSI-Codeseite des Betriebssystems anstelle der Gebietsschemacodeseite für die Zeichenfolgenübersetzung zu verwenden.
Wenn die ANSI-Version dieser Funktion mit einem Unicode-Nur-Gebietsschemabezeichner verwendet wird, kann die Funktion erfolgreich sein, da das Betriebssystem die Systemcodeseite verwendet. Zeichen, die in der Systemcodeseite nicht definiert sind, werden jedoch in der Zeichenfolge als Fragezeichen (?) angezeigt.
Ab Windows Vista sind die LOCALE_SDATE und LOCALE_STIME Konstanten veraltet. Verwenden Sie diese Konstanten nicht. Verwenden Sie stattdessen LOCALE_SSHORTDATE und LOCALE_STIMEFORMAT . Ein benutzerdefiniertes Gebietsschema verfügt möglicherweise nicht über ein einzelnes, einheitliches Trennzeichen im Datums- oder Uhrzeitformat: Beispielsweise ist ein Format wie "12/31, 2006" oder "03:56'23" möglicherweise gültig.
Hinweis
Der Winnls.h-Header definiert SetLocaleInfo als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der codierungsneutralen Aliase mit Code, der nicht codierungsneutral ist, kann zu Übereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winnls.h (enthalten Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |