Fungsi SetStdHandle

  • Artikel

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.

Value 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 4294967286yang 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

Baca juga

Fungsi Konsol

Handel Konsol

CreateFile

GetStdHandle