EnumDateFormatsExA-Funktion (winnls.h)

Artikel
11/20/2024

Listet die formate long date, short date, or year/month auf, die für ein bestimmtes Gebietsschema verfügbar sind.

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

Syntax

BOOL EnumDateFormatsExA(
  [in] DATEFMT_ENUMPROCEXA lpDateFmtEnumProcEx,
  [in] LCID                Locale,
  [in] DWORD               dwFlags
);

Parameter

[in] lpDateFmtEnumProcEx

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

[in] Locale

Gebietsschemabezeichner, der das Gebietsschema angibt, für das Datumsformatinformationen 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] dwFlags

Kennzeichen, das Datumsformate angibt. Ausführliche Definitionen finden Sie im dwFlags Parameter von EnumDateFormatsExex.

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

Hinweis Diese API wird aktualisiert, um die Änderung im japanischen Zeitalter vom Mai 2019 zu unterstützen. Wenn Ihre Anwendung den japanischen Kalender unterstützt, sollten Sie überprüfen, ob sie die neue Ära ordnungsgemäß behandelt. Weitere Informationen finden Sie unter Vorbereiten ihrer Anwendung für die japanische Ära.

Die Funktion listet die Datumsformate auf, indem Zeichenfolgenzeiger nacheinander an die angegebene anwendungsdefinierte Rückruffunktion übergeben werden. Dieser Vorgang wird fortgesetzt, bis EnumDateFormatsEx das letzte Datumsformat findet oder die Rückruffunktion FALSE-zurückgibt.

Diese Funktion listet alle Datumsformate für das angegebene Gebietsschema auf, einschließlich alternativer Kalender, falls vorhanden. Der Kalenderbezeichner wird jedoch nicht zusammen mit dem Datumsformat aufgezählt, wodurch Formate für Gebietsschemas mit alternativen Kalendern schwer zu verwenden sind.

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.

Die Anwendung sollte EnumDateFormatsEx- (anstelle von EnumDateFormats) verwenden, um Datumsformate für Gebietsschemas mit alternativen Kalendern aufzulisten.

Anmerkung

Der winnls.h-Header definiert EnumDateFormatsEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

EnumDateFormats

EnumDateFormatsEx-

EnumDateFormatsProcEx

Funktionen

Freigeben über