EnumCalendarInfoExEx-Funktion (winnls.h)

Artikel
03/04/2024

Listet Kalenderinformationen für ein durch den Namen angegebenes Gebietsschema auf.

Hinweis Die Anwendung sollte diese Funktion vor EnumCalendarInfo oder EnumCalendarInfoEx aufrufen, wenn die Ausführung nur unter Windows Vista und höher vorgesehen ist.

Hinweis Diese Funktion kann Daten aufzählen, die sich zwischen Releases ändern, z. B. aufgrund eines benutzerdefinierten Gebietsschemas. Wenn Ihre Anwendung Daten beibehalten oder übertragen muss, finden Sie weitere Informationen unter Verwenden persistenter Gebietsschemadaten.

Syntax

BOOL EnumCalendarInfoExEx(
  [in]           CALINFO_ENUMPROCEXEX pCalInfoEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           CALID                Calendar,
  [in, optional] LPCWSTR              lpReserved,
  [in]           CALTYPE              CalType,
  [in]           LPARAM               lParam
);

Parameter

[in] pCalInfoEnumProcExEx

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

[in, optional] lpLocaleName

Zeiger auf einen Gebietsschemanamen oder einen der folgenden vordefinierten Werte.

[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, optional] lpReserved

Reserviert; muss NULL sein.

[in] CalType

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

[in] lParam

Von der Anwendung bereitgestellter Parameter, der an die Rückruffunktion übergeben werden soll. Dieser Wert ist besonders nützlich für Multithreadanwendungen.

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_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
ERROR_INVALID_PARAMETER. Jeder der Parameterwerte war ungültig.

Hinweise

Diese Funktion listet kalenderinformationen für alle anwendbaren Kalender für das angegebene Gebietsschema oder für einen einzelnen angeforderten Kalender auf, abhängig vom Wert des Calendar-Parameters . Die Funktion listet die Kalenderinformationen auf, indem die angegebene anwendungsdefinierte Rückruffunktion aufgerufen wird. Der Rückruffunktion wird ein Zeiger auf einen Puffer übergeben, der die angeforderten Kalenderinformationen, einen Kalenderbezeichner und einen anwendungsdefinierten Parameter enthält, der für Multithreadanwendungen nützlich ist. Dieser Prozess wird fortgesetzt, bis EnumCalendarInfoExEx den letzten anwendbaren Kalender findet oder die Rückruffunktion FALSE zurückgibt.

Ab Windows 8: Wenn Ihre App Sprachtags aus dem Windows.Globalization-Namespace an diese Funktion übergibt, muss sie zuerst die Tags konvertieren, indem ResolveLocaleName aufgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winnls.h (windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll