FLT_PARAMETERS untuk serikat IRP_MJ_QUERY_SECURITY

Artikel
02/07/2024

Komponen union yang digunakan ketika bidang MajorFunction dari struktur FLT_IO_PARAMETER_BLOCK untuk operasi IRP_MJ_QUERY_SECURITY.

Sintaks

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    SECURITY_INFORMATION    SecurityInformation;
    ULONG POINTER_ALIGNMENT Length;
    PVOID                   SecurityBuffer;
    PDML                    MdlAddress;
  } QuerySecurity;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Anggota

QuerySecurity: Struktur yang berisi anggota berikut.

SecurityInformation: Penunjuk ke nilai SECURITY_INFORMATION yang disediakan penelepon yang menentukan informasi keamanan yang akan dikueri. Salah satu dari berikut ini:

Nilai SecurityInformation	Makna
OWNER_SECURITY_INFORMATION	Pengidentifikasi pemilik objek sedang dikueri. Memerlukan akses READ_CONTROL.
GROUP_SECURITY_INFORMATION	Pengidentifikasi grup utama objek sedang dikueri. Memerlukan akses READ_CONTROL.
DACL_SECURITY_INFORMATION	Daftar kontrol akses diskresi (DACL) objek sedang dikueri. Memerlukan akses READ_CONTROL.
SACL_SECURITY_INFORMATION	Sistem ACL (SACL) objek sedang dikueri. Memerlukan akses ACCESS_SYSTEM_SECURITY.

Panjang: Panjang, dalam byte, dari buffer yang dirujuk SecurityBuffer .
SecurityBuffer: Penunjuk ke buffer output yang disediakan penelepon yang menerima salinan deskriptor keamanan objek yang ditentukan. Proses panggilan harus memiliki hak untuk melihat aspek yang ditentukan dari status keamanan objek. Struktur SECURITY_DESCRIPTOR dikembalikan dalam format relatif mandiri. Anggota ini bersifat opsional dan dapat berupa NULL jika MDL disediakan di MdlAddress. Lihat Keterangan.
MdlAddress: Alamat daftar deskriptor memori (MDL) yang menjelaskan buffer yang ditunjuk securityBuffer . Anggota ini bersifat opsional dan dapat berupa NULL jika buffer disediakan di SecurityBuffer. Lihat Keterangan.

Keterangan

Struktur FLT_PARAMETERS untuk operasi IRP_MJ_QUERY_SECURITY berisi parameter untuk operasi informasi keamanan kueri berbasis IRP yang diwakili oleh struktur data panggilan balik (FLT_CALLBACK_DATA). Ini terkandung dalam struktur FLT_IO_PARAMETER_BLOCK .

Jika buffer SecurityBuffer dan MdlAddress disediakan, disarankan agar minifilter menggunakan MDL. Memori yang dituju SecurityBuffer valid ketika merupakan alamat mode pengguna yang diakses dalam konteks proses panggilan, atau jika itu adalah alamat mode kernel.

Jika minifilter mengubah nilai MdlAddress, maka setelah panggilan balik operasi pasca operasinya, Filter Manager akan membebaskan MDL yang saat ini disimpan di MdlAddress dan memulihkan nilai MdlAddress sebelumnya.

Pada Windows XP dan yang lebih baru, objek yang ditunjukkan oleh anggota TargetFileObject dari struktur FLT_IO_PARAMETER_BLOCK dapat mewakili aliran data bernama. Untuk informasi selengkapnya tentang aliran data bernama, lihat FILE_STREAM_INFORMATION.

IRP_MJ_QUERY_SECURITY adalah operasi berbasis IRP.