SetConsoleCP-Funktion

Legt die Eingabecodeseite fest, die von der Konsole verwendet wird, die dem aufrufenden Prozess zugeordnet ist. Eine Konsole verwendet die Eingabecodeseite, um Tastatureingaben in den entsprechenden Zeichenwert zu übersetzen.

Syntax

BOOL WINAPI SetConsoleCP(
  _In_ UINT wCodePageID
);

Parameter

wCodePageID [in]
Der Codepagebezeichner der aktuellen -Klasse. 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.

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 GetConsoleCP-Funktion, um die aktuelle Eingabecodeseite einer Konsole zu ermitteln. Zum Abrufen und Festlegen der Ausgabemodi eines Konsolenbildschirm-Puffers verwenden Sie die Funktionen GetConsoleMode und SetConsoleMode.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	ConsoleApi.h (über WinCon.h, Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Konsolen-Codepages

Konsolenfunktionen

GetConsoleCP

GetConsoleOutputCP

SetConsoleOutputCP