EnumCalendarInfoA-Funktion (winnls.h)

Artikel
08/27/2023

Listet Kalenderinformationen für ein angegebenes Gebietsschema auf.

Hinweis Um zusätzlich zu Kalenderinformationen einen Kalenderbezeichner zu erhalten, sollte die Anwendung die Funktion EnumCalendarInfoEx verwenden. Ein weiterer Grund für die Bevorzugung dieser Funktion ist, dass Microsoft aus Interoperabilitätsgründen zur Verwendung von Gebietsschemanamen anstelle von Gebietsschemabezeichnern für neue Gebietsschemas migriert.

Hinweis Jede Anwendung, die nur unter Windows Vista und höher ausgeführt wird, sollte EnumCalendarInfoExEx vor EnumCalendarInfo verwenden.

Syntax

BOOL EnumCalendarInfoA(
  [in] CALINFO_ENUMPROCA lpCalInfoEnumProc,
  [in] LCID              Locale,
  [in] CALID             Calendar,
  [in] CALTYPE           CalType
);

Parameter

[in] lpCalInfoEnumProc

Zeiger auf eine anwendungsdefinierte Rückruffunktion. Weitere Informationen finden Sie unter EnumCalendarInfoProc.

[in] Locale

Gebietsschemabezeichner , der das Gebietsschema angibt, für das Kalenderinformationen abgerufen werden sollen. Sie können das MAKELCID-Makro verwenden, um einen Gebietsschemabezeichner zu erstellen oder einen der folgenden vordefinierten Werte zu verwenden.

[in] Calendar

Kalenderbezeichner , der den Kalender angibt, für den Informationen angefordert werden. Beachten Sie, dass dieser Bezeichner ENUM_ALL_CALENDARS werden kann, um alle Kalender aufzulisten, die dem Gebietsschema zugeordnet sind.

[in] CalType

Typ der Kalenderinformationen. Weitere Informationen finden Sie unter Kalendertypinformationen. Nur ein Kalendertyp kann pro Aufruf dieser Funktion angegeben werden, sofern nicht angegeben.

Rückgabewert

Gibt bei erfolgreicher Ausführung einen wert ungleichen Wert zurück, andernfalls 0. Um erweiterte Fehlerinformationen abzurufen, kann die Anwendung GetLastError aufrufen, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:

ERROR_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
ERROR_INVALID_PARAMETER. Jeder der Parameterwerte war ungültig.

Hinweise

Weitere Informationen finden Sie unter Hinweise zu EnumCalendarInfoEx.

Hinweis

Der winnls.h-Header definiert EnumCalendarInfo 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 nicht codierungsneutralem Code 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 (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll