SetCalendarInfoA-Funktion (winnls.h)

Artikel
11/20/2024

Legt ein Element mit Gebietsschemainformationen für einen Kalender fest. Weitere Informationen finden Sie unter Datums- und Kalender-.

Syntax

BOOL SetCalendarInfoA(
  [in] LCID    Locale,
  [in] CALID   Calendar,
  [in] CALTYPE CalType,
  [in] LPCSTR  lpCalData
);

Parameter

[in] Locale

Gebietsschema-ID, die 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 Gebietsschema-IDs werden ebenfalls unterstützt.

[in] Calendar

Kalenderbezeichner für den Kalender, für den Informationen festgelegt werden sollen.

[in] CalType

Typ der festzulegenden Kalenderinformationen. Für diese Funktion sind nur die folgenden CALTYPE-Werte gültig. Die CAL_USE_CP_ACP Konstante ist nur für die ANSI-Version der Funktion aussagekräftig.

CAL_USE_CP_ACP
CAL_ITWODIGITYEARMAX

Die Anwendung kann pro Aufruf dieser Funktion nur einen Kalenderbezeichner angeben. Eine Ausnahme kann erfolgen, wenn die Anwendung den binären OR-Operator verwendet, um CAL_USE_CP_ACP mit einem beliebigen gültigen CALTYPE-Wert zu kombinieren, der in Kalendertypinformationendefiniert ist.

[in] lpCalData

Zeigen Sie auf eine Zeichenfolge mit null beendeten Kalenderinformationen. Die Informationen müssen im Format des angegebenen Kalendertyps vorliegen.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn dies erfolgreich war, oder 0 andernfalls. Um erweiterte Fehlerinformationen zu erhalten, kann die Anwendung GetLastErroraufrufen, wodurch eine der folgenden Fehlercodes zurückgegeben werden kann:

ERROR_INTERNAL_ERROR. Unerwarteter Fehler in der Funktion.
ERROR_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
ERROR_INVALID_PARAMETER. Ungültige Parameterwerte.

Bemerkungen

Diese Funktion wirkt sich nur auf den Benutzerüberschreibungsbereich der Kalendereinstellungen aus. Sie legt die Systemstandardwerte nicht fest.

Kalenderinformationen werden immer als mit Null beendete Unicode-Zeichenfolge in der Unicode-Version dieser Funktion und als NULL-gekündigte ANSI-Zeichenfolge in der ANSI-Version übergeben. Für diese Funktion sind keine ganzzahligen Zahlen zulässig. Alle numerischen Werte müssen als Unicode- oder ANSI-Text angegeben werden.

Wenn die ANSI-Version dieser Funktion mit einem Nur-Unicode-Gebietsschemabezeichner verwendet wird, kann die Funktion erfolgreich sein, da das Betriebssystem die Systemcodepage verwendet. Zeichen, die auf der Systemcodeseite nicht definiert sind, werden jedoch in der Zeichenfolge als Fragezeichen (?) angezeigt.

CAL_ITWODIGITYEARMAX können mit einem beliebigen 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 gebietsschema von Interesse unterstützt wird.

Anmerkung

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

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winnls.h (enthalten Windows.h)
Library	Kernel32.lib
DLL-	Kernel32.dll

Siehe auch

EnumCalendarInfo

GetCalendarInfo-

Funktionen

Freigeben über