Fungsi SeCaptureSubjectContext (ntifs.h)

Artikel
02/26/2024

SeCaptureSubjectContext mengambil rekam jepret dari konteks utas panggilan untuk validasi dan audit akses. Lihat juga SeCaptureSubjectContextEx.

Sintaks

void SeCaptureSubjectContext(
  [out] PSECURITY_SUBJECT_CONTEXT SubjectContext
);

Parameter

[out] SubjectContext

[keluar] Penunjuk ke struktur SECURITY_SUBJECT_CONTEXT yang dialokasikan penelepon buram. SeCaptureSubjectContext akan menulis rekam jepret profil keamanan utas panggilan, yang berisi referensi ke token akses, dalam struktur ini. Driver tidak boleh memodifikasi atau mencoba mengakses secara langsung anggota struktur ini untuk membuat keputusan keamanan. Sebagai gantinya, untuk menghindari masalah keamanan dalam otorisasi, teruskan struktur buram ini dalam panggilan ke SeAccessCheck atau SePrivilegeCheck.

Nilai kembali

Tidak ada

Keterangan

Anda harus memanggil SeCaptureSubjectContext sebelum melakukan layanan seperti validasi akses atau menghasilkan pesan audit. Ini diperlukan untuk memberikan konteks keamanan yang konsisten untuk rutinitas seperti berikut:

Setelah validasi akses, pemeriksaan hak istimewa, dan layanan pembuatan audit telah dilakukan, rilis konteks yang diambil sesegera mungkin dengan memanggil SeReleaseSubjectContext.

SeCaptureSubjectContext mengunci token seperlunya saat mengambil rekam jepret konteks keamanan utas panggilan.

Saat dikembalikan, referensi ke token akses terkandung dalam struktur yang dituju subjectContext . Isi struktur tersebut dapat berubah. Untuk mencegah hal ini, panggil SeLockSubjectContext untuk mengunci token akses utama dan token peniruan yang terkait dengan struktur. Misalnya, saat menggunakan rutinitas yang mengkueri informasi token lebih dari sekali dalam konteks keamanan yang sama (seperti yang sebelumnya tercantum), kunci konteks subjek dengan SeLockSubjectContext untuk mendapatkan hasil yang konsisten.

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 Ntifs.h, Wdm.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL