EnumDateFormatsExEx-Funktion (winnls.h)

  • Artikel

Listet die Formate für langes Datum, kurzes Datum oder Jahr/Monat auf, die für ein durch den Namen angegebenes Gebietsschema verfügbar sind.

Hinweis Die Anwendung sollte diese Funktion vor EnumDateFormats oder EnumDateFormatsEx aufrufen, wenn sie nur unter Windows Vista und höher ausgeführt werden soll.

 
Hinweis Diese Funktion kann Daten auflisten, 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 EnumDateFormatsExEx(
  [in]           DATEFMT_ENUMPROCEXEX lpDateFmtEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           DWORD                dwFlags,
  [in]           LPARAM               lParam
);

Parameter

[in] lpDateFmtEnumProcExEx

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

[in, optional] lpLocaleName

Zeiger auf einen Gebietsschemanamen oder einen der folgenden vordefinierten Werte.

[in] dwFlags

Flag, das Datumsformate angibt. Die Anwendung kann einen der folgenden Werte oder die LOCALE_USE_CP_ACP Konstante bereitstellen.

Wert Bedeutung
DATE_SHORTDATE
 Verwenden Sie kurze Datumsformate. Dieser Wert kann nicht mit anderen Flagwerten verwendet werden.
DATE_LONGDATE
 Verwenden Sie lange Datumsformate. Dieser Wert kann nicht mit anderen Flagwerten verwendet werden.
DATE_YEARMONTH
 Verwenden Sie Jahres-/Monatsformate. Dieser Wert kann nicht mit anderen Flagwerten verwendet werden.
DATE_MONTHDAY
 Verwenden Sie Monats-/Tagesformate. Dieser Wert kann nicht mit anderen Flagwerten verwendet werden.

[in] lParam

Ein 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 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_BADDB. Die Funktion konnte nicht auf die Daten zugreifen. Diese Situation sollte normalerweise nicht auftreten und weist in der Regel auf eine fehlerhafte Installation, ein Datenträgerproblem oder ähnliches hin.
  • ERROR_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
  • ERROR_INVALID_PARAMETER. Jeder der Parameterwerte war ungültig.

Hinweise

Hinweis Diese API wird aktualisiert, um die Änderung der japanischen Ära vom Mai 2019 zu unterstützen. Wenn Ihre Anwendung den japanischen Kalender unterstützt, sollten Sie überprüfen, ob sie die neue Ära ordnungsgemäß verarbeitet. Weitere Informationen finden Sie unter Vorbereiten der Anwendung für die Änderung der japanischen Ära .
 
Die Funktion listet die Datumsformate auf, indem Zeichenfolgenzeiger im Datumsformat einzeln an die angegebene anwendungsdefinierte Rückruffunktion übergeben werden, zusammen mit einer anwendungsdefinierten Konstante, die für Multithreadanwendungen nützlich ist. Dieser Prozess wird fortgesetzt, bis EnumDateFormatsExEx das letzte Datumsformat 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 (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

EnumDateFormats

EnumDateFormatsEx

EnumDateFormatsProcExEx

Unterstützung für nationale Sprachen

Nationale Sprachunterstützungsfunktionen