EnumCalendarInfoExA-Funktion (winnls.h)

Artikel
11/20/2024

Listet Kalenderinformationen für ein gebietsschema auf, das durch den Bezeichner angegeben wird.

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

Syntax

BOOL EnumCalendarInfoExA(
  [in] CALINFO_ENUMPROCEXA 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

Gebietsschema-ID, das 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 Gebietsschema-IDs 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 aufzählen, 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, es sei denn, es wird angegeben.

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

Bemerkungen

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. Sie übergibt die Rückruffunktion an einen Puffer, der die angeforderten Kalenderinformationen enthält. Dieser Vorgang wird fortgesetzt, bis EnumCalendarInfoEx den letzten anwendbaren Kalender findet, oder die Rückruffunktion gibt FALSEzurück.

Diese Funktion kann Daten aus benutzerdefinierten Gebietsschemasaufzählen. Daten sind nicht garantiert identisch von Computer zu Computer oder zwischen Ausführung einer Anwendung. Wenn Ihre Anwendung Daten beibehalten oder übertragen muss, lesen Sie Verwenden persistenter Gebietsschemadaten.

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.

Anmerkung

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

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