SetConsoleOutputCP-Funktion
Legt die Ausgabecodeseite fest, die von der Konsole verwendet wird, die dem aufrufenden Prozess zugeordnet ist. Eine Konsole verwendet die Ausgabecodeseite, um die Zeichenwerte, die von den verschiedenen Ausgabefunktionen geschrieben wurden, in die Bilder zu übersetzen, die im Konsolenfenster angezeigt werden.
Syntax
BOOL WINAPI SetConsoleOutputCP(
_In_ UINT wCodePageID
);
Parameter
wCodePageID [in]
Der Bezeichner der festzulegenden Codeseite. Weitere Informationen finden Sie in den Hinweisen.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Eine Codeseite ordnet einzelnen Zeichen 256 Zeichencodes zu. Zu verschiedenen Codepages gehören verschiedene spezielle Zeichen, die normalerweise für eine Sprache oder eine Gruppe von Sprachen angepasst sind.
Wenn die aktuelle Schriftart eine Unicode-Schriftart mit fester Neigung ist, ändert SetConsoleOutputCP die Zuordnung der Zeichenwerte in den Glyphensatz der Schriftart, anstatt bei jedem Aufruf eine separate Schriftart zu laden. Dies wirkt sich darauf aus, wie erweiterte Zeichen (ASCII-Wert größer als 127) in einem Konsolenfenster angezeigt werden. Wenn die aktuelle Schriftart jedoch eine Rasterschriftart ist, wirkt sich SetConsoleOutputCP nicht darauf aus, wie erweiterte Zeichen angezeigt werden.
Um die Codeseiten zu finden, die vom Betriebssystem installiert oder unterstützt werden, verwenden Sie die EnumSystemCodePages-Funktion. Die Bezeichner der auf dem lokalen Computer verfügbaren Codeseiten werden auch in der Registrierung unter dem folgenden Schlüssel gespeichert:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage
Es ist jedoch besser, EnumSystemCodePages zum Aufzählen von Codeseiten zu verwenden, da die Registrierung in verschiedenen Versionen von Windows unterschiedlich sein kann. Verwenden Sie die IsValidCodePage-Funktion, um zu ermitteln, ob eine bestimmte Codeseite gültig ist. Verwenden Sie die GetCPInfoEx-Funktion, um weitere Informationen zu einer Codeseite einschließlich ihres Namens abzurufen. Eine Liste der verfügbaren Codeseitenbezeichner finden Sie unter Code Page Identifiers.
Verwenden Sie die GetConsoleOutputCP-Funktion, um die aktuelle Ausgabecodeseite einer Konsole zu ermitteln. Verwenden Sie die Funktionen SetConsoleCP und GetConsoleCP, um die Eingabecodeseite einer Konsole festzulegen und abzurufen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Header | ConsoleApi2.h (über WinCon.h, Windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |