Fungsi GetHandleInformation (handleapi.h)

Mengambil properti tertentu dari handel objek.

Sintaks

BOOL GetHandleInformation(
  [in]  HANDLE  hObject,
  [out] LPDWORD lpdwFlags
);

Parameter

[in] hObject

Handel ke objek yang informasinya akan diambil.

Anda dapat menentukan handel ke salah satu jenis objek berikut: token akses, buffer input konsol, buffer layar konsol, peristiwa, file, pemetaan file, pekerjaan, mailslot, mutex, pipa, printer, proses, kunci registri, semaphore, perangkat komunikasi serial, soket, utas, atau timer yang dapat ditunggu.

[out] lpdwFlags

Penunjuk ke variabel yang menerima sekumpulan bendera bit yang menentukan properti handel objek atau 0. Nilai berikut ditentukan.

Nilai	Makna
HANDLE_FLAG_INHERIT 0x00000001	Jika bendera ini diatur, proses anak yang dibuat dengan parameter bInheritHandles dari CreateProcess diatur ke TRUE akan mewarisi handel objek.
HANDLE_FLAG_PROTECT_FROM_CLOSE 0x00000002	Jika bendera ini diatur, memanggil fungsi CloseHandle tidak akan menutup handel objek.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	handleapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

CloseHandle

CreateProcess

Menangani dan Fungsi Objek

SetHandleInformation