GetStdHandle

[funkcja] Pobiera uchwyt do określonego urządzenia (standardowe wejście, standardowe wyjście, standardowe wyjście błędów).

Składnia

#include <windows.h>

HANDLE WINAPI GetStdHandle( DWORD nStdHandle );

Argumenty

Argument

Opis

DWORD nStdHandle

Standardowe urządzenie. Argument ten może przyjmować jedną z poniższych wartości:

Wartość	Znaczenie
STD_INPUT_HANDLE	Standardowe urządzenie wejścia. Domyślnie jest to bufor wejścia konsoli.
STD_OUTPUT_HANDLE	Standardowe urządzenie wyjścia. Domyślnie jest to aktywny bufor ekranu konsoli.
STD_ERROR_HANDLE	Standardowe urządzenie wyjścia błędów. Domyślnie jest to aktywny bufor ekranu konsoli.

Zwracana wartość

Jeśli funkcja się powiedzie to wartością zwróconą będzie uchwyt do określonego urządzenia lub przekierowany uchwyt ustawiony przez poprzednie wywołanie funkcji _{» WinAPI ♦}SetStdHandle. Zwrócony uchwyt domyślnie ma prawa dostępu GENERIC_READ i GENERIC_WRITE. Uprawnienia te mogą być mniejsze jeżeli proces użył funkcji _{» WinAPI ♦}SetStdHandle w celu zmniejszenia uprawnień dla wybranego uchwytu.

Funkcja zwraca wartość INVALID_HANDLE_VALUE w przypadku wystąpienia błędu. Aby uzyskać rozszerzone informacje o błędzie, wywołaj funkcję _{» WinAPI ♦}GetLastError.

Jeśli aplikacja nie ma powiązanych standardowych uchwytów jak na przykład usługa działająca na interaktywnym pulpicie i nie ma przekierowanych innych uchwytów, zwróconą wartością będzie NULL.

Opis szczegółowy

Uchwyty zwracane przez funkcję GetStdHandle mogą być używane przez programy, które potrzebują odczytywać dane z konsoli lub pisać do konsoli. Kiedy zostaje utworzona konsola, standardowy uchwyt wejścia jest uchwytem do bufora wejściowego konsoli, a standardowy uchwyt wyjścia i standardowy uchwyt wyjścia błędów jest uchwytem do aktywnego bufora ekranu konsoli. Uchwyty te mogą być użyte przez dowolne funkcje które potrzebują dostępu do buforów konsoli.
Standardowe uchwyty procesu mogą być zmienione przez wywołanie funkcji SetStdHandle. W tym przypadku funkcja GetStdHandle zwraca zmienione uchwyty.

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional
Minimalny obsługiwany serwer	Windows 2000 Server
Biblioteka	Kernel32.lib
DLL	Kernel32.dll

Przykład

#include <windows.h>

int main()
{
HANDLE handle = GetStdHandle( STD_OUTPUT_HANDLE );
if( !handle || handle == INVALID_HANDLE_VALUE )
return 1;

SetConsoleTextAttribute( handle, 0x70 );
MessageBox( NULL, "teraz kolory na odwrot :)", " ", MB_OK );
return 0;
}

Zagadnienia powiązane

SetStdHandle	Ustawia uchwyt dla określonego standardowego urządzenia (standardowe wejście, standardowe wyjście, standardowe wyjście błędów). (funkcja)

Linki zewnętrzne

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

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.