Fungsi NtOpenThreadToken (ntifs.h)
Rutinitas NtOpenThreadToken membuka token akses yang terkait dengan utas, dan mengembalikan handel yang dapat digunakan untuk mengakses token tersebut.
Sintaks
__kernel_entry NTSYSCALLAPI NTSTATUS NtOpenThreadToken(
[in] HANDLE ThreadHandle,
[in] ACCESS_MASK DesiredAccess,
[in] BOOLEAN OpenAsSelf,
[out] PHANDLE TokenHandle
);
Parameter
[in] ThreadHandle
Tangani ke utas yang token aksesnya akan dibuka. Handel harus memiliki akses THREAD_QUERY_INFORMATION. Gunakan makro NtCurrentThread untuk menentukan utas 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 (DACL) token untuk menentukan hak akses mana yang diberikan atau ditolak.
[in] OpenAsSelf
Nilai Boolean yang menentukan apakah pemeriksaan akses akan dilakukan terhadap konteks keamanan utas yang memanggil NtOpenThreadToken atau terhadap konteks keamanan proses untuk utas panggilan.
Jika parameter ini FALSE, pemeriksaan akses dilakukan menggunakan konteks keamanan untuk utas panggilan. Jika utas meniru klien, konteks keamanan ini bisa berupa proses klien. Jika parameter ini TRUE, pemeriksaan akses dilakukan menggunakan konteks keamanan proses untuk utas panggilan.
[out] TokenHandle
Penunjuk ke variabel yang dialokasikan penelepon yang menerima handel ke token akses yang baru dibuka.
Nilai kembali
NtOpenThreadToken mengembalikan STATUS_SUCCESS atau status kesalahan yang sesuai. Kemungkinan kode status kesalahan meliputi yang berikut ini:
Menampilkan kode | Deskripsi |
---|---|
STATUS_ACCESS_DENIED | |
ThreadHandle tidak memiliki akses THREAD_QUERY_INFORMATION. | |
STATUS_CANT_OPEN_ANONYMOUS | Klien meminta tingkat peniruan SecurityAnonymous. Namun, token anonim tidak dapat dibuka. Untuk informasi selengkapnya, lihat SECURITY_IMPERSONATION_LEVEL. |
STATUS_INVALID_HANDLE | ThreadHandle bukan handel yang valid. |
STATUS_NO_TOKEN | Upaya telah dilakukan untuk membuka token yang terkait dengan utas yang saat ini tidak meniru klien. |
STATUS_OBJECT_TYPE_MISMATCH | ThreadHandle bukan handel utas. |
Keterangan
NtOpenThreadToken membuka token akses yang terkait dengan utas dan mengembalikan handel untuk token tersebut.
Parameter OpenAsSelf memungkinkan proses server untuk membuka token akses untuk proses klien ketika proses klien telah menentukan tingkat peniruan Identitas Keamanan untuk jenis SECURITY_IMPERSONATION_LEVEL enumerasi. Tanpa parameter ini, proses panggilan tidak dapat membuka token akses klien menggunakan konteks keamanan klien karena tidak mungkin untuk membuka objek tingkat eksekutif menggunakan tingkat peniruan Identitas Keamanan.
Setiap handel yang diperoleh dengan memanggil NtOpenThreadToken akhirnya harus dirilis dengan memanggil NtClose.
Untuk informasi selengkapnya tentang keamanan dan kontrol akses, lihat Model keamanan Windows untuk pengembang driver dan dokumentasi tentang topik ini di Windows SDK.
Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinitas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menafsirkan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP |
Header | ntifs.h |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk