Fungsi PsReferenceImpersonationToken (ntifs.h)
Rutinitas PsReferenceImpersonationToken menaikkan jumlah referensi token peniruan untuk utas yang ditentukan.
Sintaks
PACCESS_TOKEN PsReferenceImpersonationToken(
[in, out] PETHREAD Thread,
[out] PBOOLEAN CopyOnOpen,
[out] PBOOLEAN EffectiveOnly,
[out] PSECURITY_IMPERSONATION_LEVEL ImpersonationLevel
);
Parameter
[in, out] Thread
Alamat utas yang jumlah referensi token peniruannya akan bertambah.
[out] CopyOnOpen
Penunjuk ke variabel Boolean yang dialokasikan penelepon. Saat dikembalikan, parameter ini menerima TRUE jika token tidak dapat dibuka secara langsung. Dalam hal ini, token harus diduplikasi, dan token duplikat harus digunakan sebagai gantinya. Jika token dapat dibuka secara langsung, parameter ini menerima FALSE.
[out] EffectiveOnly
Penunjuk ke variabel Boolean yang dialokasikan penelepon. Saat dikembalikan, parameter ini menerima FALSE jika utas diizinkan untuk mengaktifkan grup dan hak istimewa yang saat ini dinonaktifkan dalam konteks keamanan klien, TRUE sebaliknya.
[out] ImpersonationLevel
Penunjuk ke variabel SECURITY_IMPERSONATION_LEVEL yang dialokasikan penelepon. Saat dikembalikan, parameter ini menerima nilai yang menentukan tingkat peniruan di mana utas diizinkan untuk mengakses token.
Nilai kembali
PsReferenceImpersonationToken mengembalikan pointer ke token peniruan untuk utas yang diberikan. Jika utas saat ini tidak meniru klien, penunjuk NULL dikembalikan.
Keterangan
Jika utas saat ini meniru klien, PsReferenceImpersonationToken akan menaikkan jumlah referensi token peniruan identitas dan mengembalikan penunjuk ke token. Jika penunjuk yang dikembalikan bukan NULL, jumlah referensi token peniruan harus dikurangi dengan memanggil salah satu fungsi berikut:
- ObDereferenceObject, untuk Windows 2000
- PsDereferenceImpersonationToken, untuk Microsoft Windows XP atau yang lebih baru
Untuk informasi selengkapnya tentang keamanan dan kontrol akses, lihat Model keamanan Windows untuk pengembang driver dan dokumentasi tentang topik ini di Windows SDK.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 |
Target Platform | Universal |
Header | ntifs.h (termasuk FltKernel.h, Ntifs.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
Aturan kepatuhan DDI | HwStorPortProhibitedDDIs(storport) |