EnumSystemCodePagesW-Funktion (winnls.h)
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 |
---|---|
|
Listet nur installierte Codeseiten auf. |
|
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 |