SetCalendarInfoA-Funktion (winnls.h)

  • Artikel

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
Die Anwendung kann pro Aufruf dieser Funktion nur einen Kalenderbezeichner angeben. Eine Ausnahme kann gemacht werden, wenn die Anwendung den binären OR-Operator verwendet, um CAL_USE_CP_ACP mit jedem gültigen CALTYPE-Wert zu kombinieren, der in Kalendertypinformationen definiert ist.

[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

Siehe auch

EnumCalendarInfo

GetCalendarInfo

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen