Freigeben über

EnumSystemCodePagesA-Funktion (winnls.h)

  • Artikel

Listet die Codeseiten auf, die entweder auf einem Betriebssystem installiert oder 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 Codeseiten auf, indem wiederholte Aufrufe an diese Rückruffunktion ausgeführt werden. Weitere Informationen finden Sie unter EnumCodePagesProc.

[in] dwFlags

Flag, das die Codeseiten angibt, die aufgezählt werden sollen. Dieser Parameter kann einen der folgenden Werte aufweisen, die sich gegenseitig ausschließen.

Wert Bedeutung
CP_INSTALLED
 Aufzählen nur installierter Codeseiten.
CP_SUPPORTED
 Aufzählen aller unterstützten Codeseiten.

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_BADDB. Die Funktion konnte nicht auf die Daten zugreifen. Diese Situation sollte normalerweise nicht auftreten und zeigt in der Regel eine fehlerhafte Installation, ein Datenträgerproblem oder ähnliches an.
  • ERROR_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
  • ERROR_INVALID_PARAMETER. Ungültige Parameterwerte.

Bemerkungen

Diese Funktion listet die Codeseiten auf, indem Codeseiten-IDs einzeln an die angegebene anwendungsdefinierte Rückruffunktion übergeben werden. Dieser Vorgang wird fortgesetzt, bis alle installierten oder unterstützten Codeseitenbezeichner an die Rückruffunktion übergeben wurden, oder die Rückruffunktion gibt FALSEzurück.

Wenn eine Anwendung diese Funktion verwendet, um eine geeignete Codeseite zum Speichern von Daten zu ermitteln, sollte unicode nach Möglichkeit verwendet werden. Andere Codeseiten sind aufgrund unterschiedlicher Implementierungen der zugehörigen Standards nicht so portierbar wie Unicode zwischen Anbietern oder Betriebssystemen.

Anmerkung

Der winnls.h-Header definiert EnumSystemCodePages 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 [Desktop-Apps | UWP-Apps]
mindestens unterstützte Server- Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform- Fenster
Header- winnls.h (enthalten Windows.h)
Library Kernel32.lib
DLL- Kernel32.dll

Siehe auch

EnumCodePagesProc

Funktionen