Fungsi SetStdHandle
Mengatur handel untuk perangkat standar yang ditentukan (input standar, output standar, atau kesalahan standar).
Sintaks
BOOL WINAPI SetStdHandle(
_In_ DWORD nStdHandle,
_In_ HANDLE hHandle
);
Parameter
nStdHandle [in]
Perangkat standar tempat handel akan diatur. Parameter ini bisa menjadi salah satu nilai berikut.
Nilai | Makna |
---|---|
STD_INPUT_HANDLE ((DWORD)-10) |
Perangkat input standar. Awalnya, ini adalah buffer input konsol, CONIN$ . |
STD_OUTPUT_HANDLE ((DWORD)-11) |
Perangkat output standar. Awalnya, ini adalah buffer layar konsol aktif, CONOUT$ . |
STD_ERROR_HANDLE ((DWORD)-12) |
Perangkat kesalahan standar. Awalnya, ini adalah buffer layar konsol aktif, CONOUT$ . |
Catatan
Nilai untuk konstanta ini adalah angka yang tidak ditandatangani, tetapi didefinisikan dalam file header sebagai cast dari nomor yang ditandatangani dan memanfaatkan kompiler C yang menggulirkannya ke tepat di bawah nilai maksimum 32-bit. Saat berinteraksi dengan handel ini dalam bahasa yang tidak mengurai header dan menentukan ulang konstanta, harap waspadai batasan ini. Sebagai contoh, ((DWORD)-10)
sebenarnya adalah angka 4294967286
yang tidak ditandatangani .
hHandle [in]
Handel untuk perangkat standar.
Nilai hasil
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Handel standar proses mungkin telah dialihkan oleh panggilan ke SetStdHandle, dalam hal ini GetStdHandle akan mengembalikan handel yang dialihkan. Jika handel standar telah dialihkan, Anda dapat menentukan nilai CONIN$ dalam panggilan ke fungsi CreateFile untuk mendapatkan handel ke buffer input konsol. Demikian pula, Anda dapat menentukan nilai CONOUT$ untuk mendapatkan handel ke buffer layar aktif konsol.
Contoh
Misalnya, lihat Membuat Proses Anak dengan Input dan Output yang Dialihkan.
Persyaratan
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Header | ProcessEnv.h (melalui Winbase.h, sertakan Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |