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 |