EnumTimeFormatsA-Funktion (winnls.h)

Artikel
11/20/2024

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

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

Syntax

BOOL EnumTimeFormatsA(
  [in] TIMEFMT_ENUMPROCA lpTimeFmtEnumProc,
  [in] LCID              Locale,
  [in] DWORD             dwFlags
);

Parameter

[in] lpTimeFmtEnumProc

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

[in] Locale

Gebietsschema-ID, das das Gebietsschema angibt, für das Informationen zum Zeitformat 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.

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

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

Die Funktion listet die Zeitformate auf, indem ein Zeiger an einen Puffer übergeben wird, der ein Zeitformat an eine anwendungsdefinierte Rückruffunktion enthält. Der erste Wert in der Enumeration ist immer der Standardwert (Außerkraftsetzung) des Benutzers. Die Funktion setzt die Aufzählung fort, bis das letzte Mal gefunden wurde, 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 Unicode-Nur-Gebietsschemabezeichner verwendet wird, kann der Aufruf erfolgreich ausgeführt werden, da das System die Systemcodepage verwendet. Zeichen, die auf der Systemcodeseite nicht definiert sind, werden jedoch in der Zeichenfolge als Fragezeichen ("?") angezeigt. Beachten Sie, dass alle neuen Werte für dwFlags-, die in Zukunft eingeführt wurden, nicht mit der ANSI-Version funktionieren.

Anmerkung

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

EnumTimeFormatsEx

EnumTimeFormatsProc

Funktionen

Freigeben über