EnumSystemCodePagesA-Funktion (winnls.h)
Listet die Codepages auf, die entweder auf einem Betriebssystem installiert sind oder von diesem unterstützt werden.
Syntax
BOOL EnumSystemCodePagesA(
[in] CODEPAGE_ENUMPROCA lpCodePageEnumProc,
[in] DWORD dwFlags
);
Parameter
[in] lpCodePageEnumProc
Zeiger auf eine anwendungsdefinierte Rückruffunktion. Die EnumSystemCodePages-Funktion listet Codepages auf, indem sie diese Rückruffunktion wiederholt aufruft. Weitere Informationen finden Sie unter EnumCodePagesProc.
[in] dwFlags
Flag, das die zu enumerierenden Codepages angibt. Dieser Parameter kann einen der folgenden Werte aufweisen, die sich gegenseitig ausschließen.
| Wert | Bedeutung |
|---|---|
|
Listet nur installierte Codepages auf. |
|
Listet alle unterstützten Codepages auf. |
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_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
Diese Funktion listet die Codepages auf, indem codepage-Bezeichner einzeln an die angegebene anwendungsdefinierte Rückruffunktion übergeben werden. Dieser Prozess wird fortgesetzt, bis alle installierten oder unterstützten Codepagebezeichner an die Rückruffunktion übergeben wurden oder die Rückruffunktion FALSE zurückgibt.
Wenn eine Anwendung diese Funktion verwendet, um eine geeignete Codepage zum Speichern von Daten zu ermitteln, sollte sie nach Möglichkeit Unicode verwenden. Andere Codepages sind aufgrund unterschiedlicher Implementierungen der zugehörigen Standards nicht so portierbar wie Unicode zwischen Anbietern oder Betriebssystemen.
Hinweis
Der winnls.h-Header definiert EnumSystemCodePages 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 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winnls.h (windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |