EnumTimeFormatsEx-Funktion (winnls.h)

Artikel
08/27/2023

Listet die Zeitformate auf, die für ein durch den Namen angegebenes Gebietsschema verfügbar sind.

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

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 EnumTimeFormatsEx(
  [in]           TIMEFMT_ENUMPROCEX lpTimeFmtEnumProcEx,
  [in, optional] LPCWSTR            lpLocaleName,
  [in]           DWORD              dwFlags,
  [in]           LPARAM             lParam
);

Parameter

[in] lpTimeFmtEnumProcEx

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

[in, optional] lpLocaleName

Zeiger auf einen Gebietsschemanamen oder einen der folgenden vordefinierten Werte.

[in] dwFlags

Das Zeitformat. Legen Sie auf 0 fest, um das Lange-Zeit-Format des aktuellen Benutzers zu verwenden, oder TIME_NOSECONDS (ab Windows 7), um das Kurzzeitformat zu verwenden.

[in] lParam

Ein von der Anwendung bereitgestellter Parameter, der an die Rückruffunktion übergeben werden soll. Dies 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 die Zeitformate auf, indem die Zeitformatzeichenfolgenzeiger einzeln an die angegebene anwendungsdefinierte Rückruffunktion übergeben werden, zusammen mit einer anwendungsdefinierten Konstante, die für Multithreadanwendungen nützlich ist. Der erste Wert in der Enumeration ist immer der Standardwert (Außerkraftsetzung) des Benutzers. Die Funktion setzt die Enumeration fort, bis das letzte Format gefunden wird 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

Siehe auch

EnumTimeFormats

EnumTimeFormatsProcEx

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen

Freigeben über