EnumTimeFormatsW-Funktion (winnls.h)

Artikel
03/04/2024

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

Hinweis Aus Gründen der Interoperabilität sollte die Anwendung die EnumTimeFormatsEx-Funktion gegenüber EnumTimeFormats vorziehen, da Microsoft zur Verwendung von Gebietsschemanamen anstelle von Gebietsschemabezeichnern für neue Gebietsschemas migriert. Jede Anwendung, die nur unter Windows Vista und höher ausgeführt wird, sollte EnumTimeFormatsEx verwenden.

Syntax

BOOL EnumTimeFormatsW(
  [in] TIMEFMT_ENUMPROCW lpTimeFmtEnumProc,
  [in] LCID              Locale,
  [in] DWORD             dwFlags
);

Parameter

[in] lpTimeFmtEnumProc

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

[in] Locale

Gebietsschemabezeichner , der das Gebietsschema angibt, für das Zeitformatinformationen abgerufen werden sollen. Sie können das MAKELCID-Makro verwenden, um einen Gebietsschemabezeichner zu erstellen oder einen der folgenden vordefinierten Werte zu verwenden.

[in] dwFlags

Das Zeitformat. Dieser Parameter kann eine Kombination aus einem der folgenden Werte angeben.

Flag	Bedeutung
0	Verwenden Sie das lange Zeitformat des aktuellen Benutzers.
TIME_NOSECONDS	Windows 7 und höher: Verwenden Sie das Kurzzeitformat des aktuellen Benutzers. Hinweis Dieser Wert funktioniert nicht mit der ANSI-Version dieser Funktion, EnumTimeFormatsA.
LOCAL_USE_CP_ACP	Wird mit der ANSI-Version dieser Funktion EnumTimeFormatsA (nicht empfohlen) angegeben, um die Standardmäßige Windows ANSI-Codepage (ACP) anstelle der Gebietsschemacodepage zu verwenden.

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

Die Funktion listet die Zeitformate auf, indem sie einen Zeiger an einen Puffer mit einem Zeitformat an eine anwendungsdefinierte Rückruffunktion übergibt. 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.

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 der Aufruf erfolgreich sein, da das System die Systemcodepage verwendet. Jedoch werden Zeichen, die auf der Systemcodepage nicht definiert sind, in der Zeichenfolge als Fragezeichen ("?") angezeigt. Beachten Sie, dass alle in Zukunft eingeführten neuen Werte für dwFlags nicht mit der ANSI-Version funktionieren.

Hinweis

Der winnls.h-Header definiert EnumTimeFormats 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
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

EnumTimeFormatsEx

EnumTimeFormatsProc

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen

Share via