EnumSystemCodePagesW-Funktion (winnls.h)

Artikel
03/04/2024

Listet die Codepages auf, die entweder auf einem Betriebssystem installiert oder von einem Betriebssystem unterstützt werden.

Syntax

BOOL EnumSystemCodePagesW(
  [in] CODEPAGE_ENUMPROCW lpCodePageEnumProc,
  [in] DWORD              dwFlags
);

Parameter

[in] lpCodePageEnumProc

Zeiger auf eine anwendungsdefinierte Rückruffunktion. Die EnumSystemCodePages-Funktion listet Codepages auf, indem diese Rückruffunktion wiederholt aufgerufen wird. Weitere Informationen finden Sie unter EnumCodePagesProc.

[in] dwFlags

Flag, das die zu enumerierenden Codeseiten angibt. Dieser Parameter kann einen der folgenden Werte aufweisen, die sich gegenseitig ausschließen.

Wert	Bedeutung
CP_INSTALLED	Listet nur installierte Codeseiten auf.
CP_SUPPORTED	Listet alle unterstützten Codeseiten auf.

Rückgabewert

Gibt bei erfolgreicher Ausführung einen wert ungleichen Wert zurück, andernfalls 0. Um erweiterte Fehlerinformationen abzurufen, 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 Codepagebezeichner 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 portabel 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 nicht codierungsneutralem Code 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 (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

EnumCodePagesProc

Unterstützung für nationale Sprachen

Nationale Sprachunterstützungsfunktionen

Share via