EnumDateFormatsExA-Funktion (winnls.h)
Listet die Formate für langes Datum, kurzes Datum oder Jahr/Monat auf, die für ein angegebenes Gebietsschema verfügbar sind.
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 Gebietsschemabezeichner werden ebenfalls unterstützt.[in] dwFlags
Flag, das Datumsformate angibt. Ausführliche Definitionen finden Sie im dwFlags-Parameter von EnumDateFormatsExEx.
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 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, was die Verwendung von Formaten für Gebietsschemas mit alternativen Kalendern erschwert.
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 die Funktion erfolgreich ausgeführt werden, da das Betriebssystem die Systemcodepage verwendet. Jedoch werden Zeichen, die auf der Systemcodepage nicht definiert sind, in der Zeichenfolge als Fragezeichen (?) angezeigt.
Die Anwendung sollte EnumDateFormatsEx (anstelle von EnumDateFormats) verwenden, um Datumsformate für Gebietsschemas mit alternativen Kalendern aufzulisten.
Hinweis
Der winnls.h-Header definiert EnumDateFormatsEx 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 |