EnumCalendarInfoExW-Funktion (winnls.h)
Listet Kalenderinformationen für ein durch den Bezeichner angegebenes Gebietsschema auf.
Syntax
BOOL EnumCalendarInfoExW(
[in] CALINFO_ENUMPROCEXW lpCalInfoEnumProcEx,
[in] LCID Locale,
[in] CALID Calendar,
[in] CALTYPE CalType
);
Parameter
[in] lpCalInfoEnumProcEx
Zeiger auf eine anwendungsdefinierte Rückruffunktion. Weitere Informationen finden Sie unter EnumCalendarInfoProcEx.
[in] Locale
Gebietsschemabezeichner , der das Gebietsschema angibt, für das Kalenderinformationen abgerufen werden sollen. Sie können das MAKELCID-Makro verwenden, um einen Bezeichner zu erstellen oder einen der folgenden vordefinierten Werte zu verwenden.
Windows Vista und höher: Die folgenden benutzerdefinierten Gebietsschemabezeichner werden ebenfalls unterstützt.[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. Pro Aufruf dieser Funktion kann nur ein Kalendertyp angegeben werden, sofern nicht angegeben.
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 enthält. Dieser Prozess wird fortgesetzt, bis EnumCalendarInfoEx den letzten anwendbaren Kalender findet oder die Rückruffunktion FALSE zurückgibt.
Diese Funktion kann Daten aus benutzerdefinierten Gebietsschemas auflisten. Es ist nicht garantiert, dass die Daten von Computer zu Computer oder zwischen Ausführungen einer Anwendung identisch sind. Wenn Ihre Anwendung Daten beibehalten oder übertragen muss, finden Sie weitere Informationen unter Verwenden persistenter Gebietsschemadaten.
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.
Hinweis
Der winnls.h-Header definiert EnumCalendarInfoEx 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für