Fungsi OpenProcessToken (processthreadsapi.h)
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 |