Fungsi UserHandleGrantAccess (winuser.h)

Artikel
08/28/2023

Memberikan atau menolak akses ke handel ke objek Pengguna ke pekerjaan yang memiliki pembatasan antarmuka pengguna. Ketika akses diberikan, semua proses yang terkait dengan pekerjaan kemudian dapat mengenali dan menggunakan handel. Ketika akses ditolak, proses tidak dapat lagi menggunakan handel. Untuk informasi selengkapnya lihat Objek Pengguna.

Sintaks

BOOL UserHandleGrantAccess(
  [in] HANDLE hUserHandle,
  [in] HANDLE hJob,
  [in] BOOL   bGrant
);

Parameter

[in] hUserHandle

Handel ke objek Pengguna.

[in] hJob

Handel ke pekerjaan yang akan diberikan akses ke handel Pengguna. Fungsi CreateJobObject atau OpenJobObject mengembalikan handel ini.

[in] bGrant

Jika parameter ini TRUE, semua proses yang terkait dengan pekerjaan dapat mengenali dan menggunakan handel. Jika parameternya FALSE, proses tidak dapat menggunakan handel.

Mengembalikan nilai

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

Fungsi UserHandleGrantAccess hanya dapat dipanggil dari proses yang tidak terkait dengan pekerjaan yang ditentukan oleh parameter hJob . Handel Pengguna tidak boleh dimiliki oleh proses atau utas yang terkait dengan pekerjaan.

Untuk membuat pembatasan antarmuka pengguna, panggil fungsi SetInformationJobObject dengan kelas informasi pekerjaan JobObjectBasicUIRestrictions.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll