Fungsi PsReferenceImpersonationToken (ntifs.h)

Artikel
02/26/2024

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)

Lihat juga

ObDereferenceObject

PsDereferenceImpersonationToken

PsImpersonateClient

SECURITY_IMPERSONATION_LEVEL

Bagikan melalui