Bagikan melalui

Fungsi ZwOpenProcessTokenEx (ntifs.h)

  • Artikel

Rutinitas ZwOpenProcessTokenEx membuka token akses yang terkait dengan proses.

Sintaksis

NTSYSAPI NTSTATUS ZwOpenProcessTokenEx(
  [in]  HANDLE      ProcessHandle,
  [in]  ACCESS_MASK DesiredAccess,
  [in]  ULONG       HandleAttributes,
  [out] PHANDLE     TokenHandle
);

Parameter

[in] ProcessHandle

Tangani ke proses yang token aksesnya akan dibuka. Handel harus memiliki akses PROCESS_QUERY_INFORMATION. Gunakan makro NtCurrentProcess, yang ditentukan dalam Ntddk.h, untuk menentukan proses saat ini.

[in] DesiredAccess

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

[in] HandleAttributes

Atribut untuk handel token akses. Hanya OBJ_KERNEL_HANDLE yang saat ini didukung. Jika pemanggil tidak berjalan dalam konteks proses sistem, pemanggil harus menentukan OBJ_KERNEL_HANDLE untuk parameter ini.

[out] TokenHandle

Penunjuk ke variabel yang dialokasikan pemanggil yang menerima handel ke token akses yang baru dibuka.

Mengembalikan nilai

ZwOpenProcessTokenEx mengembalikan STATUS_SUCCESS atau status kesalahan yang sesuai. Kemungkinan kode status kesalahan meliputi yang berikut ini:

Mengembalikan kode Deskripsi
STATUS_ACCESS_DENIED ProcessHandle tidak memiliki akses PROCESS_QUERY_INFORMATION.
STATUS_INSUFFICIENT_RESOURCES Handel token baru tidak dapat dialokasikan.
STATUS_INVALID_HANDLE ProcessHandle bukan handel yang valid.
STATUS_INVALID_PARAMETER HandleAttributes yang ditentukan tidak menyertakan OBJ_KERNEL_HANDLE.
STATUS_OBJECT_TYPE_MISMATCH ProcessHandle bukan handel proses.
STATUS_PRIVILEGE_NOT_HELD Pemanggil tidak memiliki hak istimewa (SeSecurityPrivilege) yang diperlukan untuk membuat handel token dengan akses yang ditentukan dalam parameter DesiredAccess.
STATUS_QUOTA_EXCEEDED Kuota memori proses tidak cukup untuk mengalokasikan handel token.
STATUS_UNSUCCESSFUL Handel token tidak dapat dibuat.

Komentar

ZwOpenProcessTokenEx membuka token akses yang terkait dengan proses dan mengembalikan handel untuk token tersebut.

Setiap handel yang diperoleh dengan memanggil ZwOpenProcessTokenEx akhirnya harus dirilis dengan memanggil ZwClose.

Rutinitas driver yang berjalan dalam konteks proses selain proses sistem harus mengatur atribut OBJ_KERNEL_HANDLE untuk parameter HandleAttributesZwOpenProcessTokenEx. Ini membatasi penggunaan handel yang dikembalikan oleh ZwOpenProcessTokenEx untuk memproses yang berjalan dalam mode kernel. Jika tidak, handel dapat diakses oleh proses dalam konteks driver berjalan.

Untuk informasi selengkapnya tentang keamanan dan kontrol akses, lihat model keamanan Windows untuk pengembang driver dan dokumentasi tentang topik ini di Windows SDK.

Nota

Jika panggilan ke fungsi ZwOpenProcessTokenEx terjadi dalam mode pengguna, Anda harus menggunakan nama "NtOpenProcessTokenEx" alih-alih "ZwOpenProcessTokenEx".

Untuk panggilan dari driver mode kernel, NtXxx dan ZwXxx versi rutin Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menginterpretasikan parameter input. Untuk informasi selengkapnya tentang hubungan antara NtXxx dan versi ZwXxx rutin, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows XP
Platform Target Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
aturan kepatuhan DDI HwStorPortProhibitedDIs (storport), PowerIrpDDis(wdm)

Lihat juga

ACCESS_MASK

ACL

PsDereferencePrimaryToken

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwClose

ZwOpenThreadTokenEx