CONSOLE_READCONSOLE_CONTROL-Struktur

Artikel
12/21/2023

Enthält Informationen für einen Konsolenlesevorgang.

Syntax

typedef struct _CONSOLE_READCONSOLE_CONTROL {
  ULONG nLength;
  ULONG nInitialChars;
  ULONG dwCtrlWakeupMask;
  ULONG dwControlKeyState;
} CONSOLE_READCONSOLE_CONTROL, *PCONSOLE_READCONSOLE_CONTROL;

Member

nLength
Die Größe dieser Struktur. Legen Sie dieses Element auf sizeof(CONSOLE_READCONSOLE_CONTROL).

nInitialChars
Die Anzahl der Zeichen, die übersprungen werden sollen (und somit beibehalten werden), bevor neu gelesene Eingaben im Puffer geschrieben werden, die an die ReadConsole-Funktion übergeben werden. Dieser Wert muss kleiner als der nNumberOfCharsToRead-Parameter der ReadConsole-Funktion sein.

dwCtrlWakeupMask
Eine Maske, die angibt, welche Steuerzeichen zwischen 0x00 und 0x1F verwendet werden soll, um zu signalisieren, dass das Lesen abgeschlossen ist. Jedes Bit entspricht einem Zeichen mit dem am wenigsten signifikanten Bit, das bzwNUL. dem das wichtigste Bit entspricht 0x00 oder das wichtigste Bit, das bzwUS. das entspricht0x1F. Es können mehrere Bits (Steuerzeichen) angegeben werden.

dwControlKeyState
Der Zustand der Steuerschlüssel. Dieser Member kann einen oder mehrere der folgenden Werte annehmen:

Wert	Bedeutung
CAPSLOCK_ON 0x0080	Die FESTSTELLTASTE ist eingeschaltet.
ENHANCED_KEY 0x0100	Der Schlüssel wird erweitert. Siehe Bemerkungen.
LEFT_ALT_PRESSED 0x0002	Die linke ALT-TASTE wird gedrückt.
LEFT_CTRL_PRESSED 0x0008	Die linke STRG-TASTE wird gedrückt.
NUMLOCK_ON 0x0020	Die NUM-SPERRleuchte ist aktiviert.
RIGHT_ALT_PRESSED 0x0001	Die rechte ALT-TASTE wird gedrückt.
RIGHT_CTRL_PRESSED 0x0004	Die rechte STRG-TASTE wird gedrückt.
SCROLLLOCK_ON 0x0040	Die BILDLAUFSPERRE ist aktiviert.
SHIFT_PRESSED 0x0010	Die UMSCHALTTASTE wird gedrückt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	ConsoleApi.h (über WinCon.h, Windows.h einschließen)

Siehe auch

ReadConsole