Jegyzet
Az oldalhoz való hozzáférés engedélyezést igényel. Próbálhatod be jelentkezni vagy könyvtárat váltani.
Az oldalhoz való hozzáférés engedélyezést igényel. Megpróbálhatod a könyvtár váltását.
Beolvassa az adatokat a konzol bemeneti pufferéből, és konfigurálható viselkedéssel eltávolítja azokat a pufferből.
Jegyzet Ez a függvény nem rendelkezik társított importálási kódtárval. Ez a függvény a ReadConsoleInputExA és a ReadConsoleInputExW nevű erőforrásként érhető el Kernel32.dll. A Kernel32.dlldinamikus csatolásához a LoadLibrary és a GetProcAddress függvényt kell használnia.
Szemantika
BOOL WINAPI ReadConsoleInputEx(
_In_ HANDLE hConsoleInput,
_Out_ PINPUT_RECORD lpBuffer,
_In_ DWORD nLength,
_Out_ LPDWORD lpNumberOfEventsRead,
_In_ USHORT wFlags
);
Paraméterek
hConsoleInput [in]
Egy fogópont a konzol bemeneti pufferéhez. A fogópontnak rendelkeznie kell a GENERIC_READ hozzáférési joggal. További információ: Konzolpuffer biztonsági és hozzáférési jogosultságai.
lpBuffer [ki]
A bemeneti pufferadatokat fogadó INPUT_RECORD struktúrák tömbjének mutatója.
nLength [in]
Az lpBuffer paraméter által mutatott tömb mérete tömbelemekben.
lpNumberOfEventsRead [kimenő]
Egy olyan változóra mutató mutató, amely a bemeneti rekordok olvasási számát fogadja.
wFlags [in]
A konzol olvasási viselkedését meghatározó jelzők (ORed együtt) készlete.
| Érték | Értelmezés |
|---|---|
CONSOLE_READ_NOREMOVE0x0001 |
Hagyja az eseményeket a bemeneti pufferben (mint PeekConsoleInput) |
CONSOLE_READ_NOWAIT0x0002 |
Azonnal térjen vissza, még akkor is, ha a bemeneti pufferben nincsenek események. |
Visszaadott érték
Ha a függvény sikeres, a visszatérési érték nem lesz nulla.
Ha a függvény sikertelen, a visszatérési érték nulla. A kiterjesztett hibainformációk lekéréséhez hívja meg a GetLastErrort.
Megjegyzések
Ez a függvény a ReadConsoleInput konfigurálható verziója. A további működési részletekért tekintse meg a megjegyzéseket ReadConsoleInput.
A jelölőkkel való hívás ReadConsoleInputEx egyenértékű a hívássalPeekConsoleInput.CONSOLE_READ_NOREMOVE | CONSOLE_READ_NOWAIT
Ez a függvény nem létezik a Windows-konzol fejléceiben. Ha C vagy C++ alkalmazásból szeretne hozzáférést szerezni hozzá, adja meg a következő deklarációkat, és dinamikusan csatolja kernel32.dll a fent leírtak szerint.
#ifndef CONSOLE_READ_NOREMOVE
#define CONSOLE_READ_NOREMOVE 0x0001
#endif
#ifndef CONSOLE_READ_NOWAIT
#define CONSOLE_READ_NOWAIT 0x0002
#endif
BOOL
WINAPI
ReadConsoleInputExA(
_In_ HANDLE hConsoleInput,
_Out_writes_(nLength) PINPUT_RECORD lpBuffer,
_In_ DWORD nLength,
_Out_ LPDWORD lpNumberOfEventsRead,
_In_ USHORT wFlags);
BOOL
WINAPI
ReadConsoleInputExW(
_In_ HANDLE hConsoleInput,
_Out_writes_(nLength) PINPUT_RECORD lpBuffer,
_In_ DWORD nLength,
_Out_ LPDWORD lpNumberOfEventsRead,
_In_ USHORT wFlags);
Követelmények
| Minimálisan támogatott ügyfél | Windows 7 [csak asztali alkalmazások] |
| Minimálisan támogatott kiszolgáló | Windows Server 2003 [csak asztali alkalmazások] |
| Fejléc | nincs, lásd a megjegyzéseket |
| Könyvtár | nincs, lásd a megjegyzéseket |
| DLL | Kernel32.dll |
| Unicode- és ANSI-nevek | ReadConsoleInputExW (Unicode) és ReadConsoleInputExA (ANSI) |