Fungsi OpenProcessToken (processthreadsapi.h)

Artikel
03/04/2024

Fungsi OpenProcessToken membuka token akses yang terkait dengan proses.

Sintaks

BOOL OpenProcessToken(
  [in]  HANDLE  ProcessHandle,
  [in]  DWORD   DesiredAccess,
  [out] PHANDLE TokenHandle
);

Parameter

[in] ProcessHandle

Handel untuk proses yang token aksesnya dibuka. Proses harus memiliki izin akses PROCESS_QUERY_LIMITED_INFORMATION. Lihat Keamanan Proses dan Hak Akses untuk informasi selengkapnya.

[in] DesiredAccess

Menentukan masker akses yang menentukan jenis akses yang diminta ke token akses. Jenis akses yang diminta ini dibandingkan dengan daftar kontrol akses diskresi (DACL) token untuk menentukan akses mana yang diberikan atau ditolak.

Untuk daftar hak akses untuk token akses, lihat Hak Akses untuk Objek Access-Token.

[out] TokenHandle

Penunjuk ke handel yang mengidentifikasi token akses yang baru dibuka saat fungsi kembali.

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 mendapatkan handel ke proses yang ditingkatkan dari dalam proses yang tidak ditingkatkan, kedua proses harus dimulai dari akun yang sama.

Jika proses yang diperiksa dimulai oleh akun lain, proses pemeriksaan harus mengaktifkan hak istimewa SE_DEBUG_NAME. Lihat Konstanta Hak Istimewa (Otorisasi) untuk informasi selengkapnya.

Untuk menutup handel token akses yang dikembalikan melalui parameter TokenHandle , panggil CloseHandle.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	processthreadsapi.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll