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
CP_INSTALLED	Listet nur installierte Codepages auf.
CP_SUPPORTED	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

Siehe auch

EnumCodePagesProc

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen