ReadConsoleOutputCharacter

Składnia

Argumenty

Argument	Opis
hConsoleOutput	Uchwyt do bufora ekranu konsoli. Uchwyt musi mieć dostęp GENERIC_READ.
lpCharacter	Wskaźnik do bufora pobierającego znaki z bufora ekranu konsoli. Miejsce w pamięci na ten bufor jest alokowane na stercie dla procesu zajmującego 64 KB pamięci. Maksymalny rozmiar bufora zależy od użycia sterty.
nLength	Liczba komórek znaków bufora ekranu do odczytania. Rozmiar bufora wskazywanego przez argument lpCharacter powinien wynosić nLength * sizeof( TCHAR ) .
dwReadCoord	Współrzędne pierwszej komórki w buforze ekranu konsoli do odczytania (w znakach).
lpNumberOfCharsRead	Wskaźnik do zmiennej pobierającej liczbę aktualnie odczytanych znaków.

Zwracana wartość

Jeśli nie wystąpią błędy, zwracana wartość jest niezerowa, inaczej 0. Aby uzyskać szczegółowe informacje o błędzie, wywołaj funkcję _{» WinAPI ♦} GetLastError.

Dodatkowe informacje

Jeśli liczba znaków do odczytania wykracza poza koniec wiersza bufora ekranu, znaki są odczytywane z następnego wiersza. Jeśli liczba znaków do odczytania wykracza poza koniec bufora ekranu konsoli, znaki do końca bufora ekranu konsoli są odczytywane. Ta funkcja używa 8-bitowych znaków Unicode z obecnej strony kodowej konsoli. Domyślna strona kodowa jest stroną kodową OEM. Do zmiany strony kodowej służą funkcje _{» WinAPI ♦} SetConsoleCP oraz _{» WinAPI ♦} SetConsoleOutputCP. Można również użyć polecenia  lub .

Wymagania

Minimalny system klienta	Windows 2000 Professional (tylko aplikacje biurowe).
Minimalny system serwera	Windows 2000 Server (tylko aplikacje biurowe).
Nagłówek	Wincon.h (dołącza Windows.h)
Biblioteka	Kernel32.lib
DLL	Kernel32.dll
UNICODE	ReadConsoleOutputCharacterW
ANSI	ReadConsoleOutputCharacterA

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/windows/desktop/ms684969(v=vs.85).aspx