Freigeben über


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

Siehe auch

Konsolen-Codepages

Konsolenfunktionen

GetConsoleCP

GetConsoleOutputCP

SetConsoleCP