Fungsi SetHandleInformation (handleapi.h)

Artikel
08/24/2023

Mengatur properti tertentu dari handel objek.

Sintaks

BOOL SetHandleInformation(
  [in] HANDLE hObject,
  [in] DWORD  dwMask,
  [in] DWORD  dwFlags
);

Parameter

[in] hObject

Handel ke objek yang informasinya akan diatur.

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.

[in] dwMask

Masker yang menentukan bendera bit yang akan diubah. Gunakan konstanta yang sama yang ditunjukkan dalam deskripsi dwFlags.

[in] dwFlags

Set bendera bit yang menentukan properti handel objek. Parameter ini bisa 0 atau satu atau beberapa nilai berikut.

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.

Keterangan

Untuk mengatur atau menghapus bendera bit terkait di dwFlags, Anda harus mengatur bendera bit masker perubahan di dwMask.

Persyaratan


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

GetHandleInformation

Menangani dan Fungsi Objek

Share via