SetCalendarInfoA-Funktion (winnls.h)
Legt ein Element mit Gebietsschemainformationen für einen Kalender fest. Weitere Informationen finden Sie unter Datum und Kalender.
Syntax
BOOL SetCalendarInfoA(
[in] LCID Locale,
[in] CALID Calendar,
[in] CALTYPE CalType,
[in] LPCSTR lpCalData
);
Parameter
[in] Locale
Gebietsschemabezeichner , der das Gebietsschema angibt. 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] Calendar
Kalenderbezeichner für den Kalender, für den Informationen festgelegt werden sollen.
[in] CalType
Typ der festzulegenden Kalenderinformationen. Nur die folgenden CALTYPE-Werte sind für diese Funktion gültig. Die CAL_USE_CP_ACP Konstante ist nur für die ANSI-Version der Funktion sinnvoll.
- CAL_USE_CP_ACP
- CAL_ITWODIGITYEARMAX
[in] lpCalData
Zeiger auf eine mit NULL beendete Kalenderinformationszeichenfolge. Die Informationen müssen im Format des angegebenen Kalendertyps vorliegen.
Rückgabewert
Gibt bei erfolgreicher Ausführung einen Wert ungleich 0 zurück, andernfalls 0. Um erweiterte Fehlerinformationen zu erhalten, kann die Anwendung GetLastError aufrufen, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:
- ERROR_INTERNAL_ERROR. In der Funktion ist ein unerwarteter Fehler aufgetreten.
- ERROR_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
- ERROR_INVALID_PARAMETER. Jeder der Parameterwerte war ungültig.
Hinweise
Diese Funktion wirkt sich nur auf den Benutzer überschreibt einen Teil der Kalendereinstellungen. Die Systemstandardeinstellungen werden nicht festgelegt.
Kalenderinformationen werden in der Unicode-Version dieser Funktion immer als mit NULL endende Unicode-Zeichenfolge und in der ANSI-Version als NULL-beendete ANSI-Zeichenfolge übergeben. Diese Funktion erlaubt keine ganzen Zahlen. Alle numerischen Werte müssen entweder als Unicode- oder ANSI-Text angegeben werden.
Wenn die ANSI-Version dieser Funktion mit einem reinen Unicode-Gebietsschemabezeichner verwendet wird, kann die Funktion erfolgreich ausgeführt werden, da das Betriebssystem die Systemcodepage verwendet. Jedoch werden Zeichen, die auf der Systemcodepage nicht definiert sind, in der Zeichenfolge als Fragezeichen (?) angezeigt.
CAL_ITWODIGITYEARMAX kann mit jedem Kalender verwendet werden, auch wenn der Kalender für das angegebene Gebietsschema nicht unterstützt wird. Um Komplikationen zu vermeiden, sollte die Anwendung EnumCalendarInfo aufrufen, um sicherzustellen, dass der Kalender für das von Interesse ist.
Hinweis
Der winnls.h-Header definiert SetCalendarInfo als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtü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 (windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |