Fungsi FltRequestSecurityInfoOnCreateCompletion (fltkernel.h)
Minifilter memanggil FltRequestSecurityInfoOnCreateCompletion selama pra-buat file untuk meminta sistem file menyimpan informasi keamanan file untuk diambil selama pembuatan pos.
Sintaks
NTSTATUS FLTAPI FltRequestSecurityInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
SECURITY_INFORMATION SecurityInformation
);
Parameter
Filter
Penunjuk filter buram yang secara unik mengidentifikasi driver minifilter.
Data
Arahkan ke data panggilan balik FLT_CALLBACK_DATA yang mewakili operasi pembuatan I/O.
SecurityInformation
SECURITY_INFORMATION nilai yang menentukan informasi yang akan ditetapkan sebagai kombinasi dari satu atau beberapa hal berikut ini.
| Nilai | Makna |
|---|---|
| OWNER_SECURITY_INFORMATION | Menunjukkan pengidentifikasi pemilik objek akan diatur. Memerlukan akses WRITE_OWNER. |
| GROUP_SECURITY_INFORMATION | Menunjukkan pengidentifikasi grup utama objek yang akan diatur. Memerlukan akses WRITE_OWNER. |
| DACL_SECURITY_INFORMATION | Menunjukkan daftar kontrol akses diskresi (DACL) objek yang akan diatur. Membutuhkan akses WRITE_DAC. |
| SACL_SECURITY_INFORMATION | Menunjukkan sistem ACL (SACL) objek yang akan diatur. Memerlukan akses ACCESS_SYSTEM_SECURITY. |
Mengembalikan nilai
FltRequestSecurityInfoOnCreateCompletion dapat mengembalikan salah satu nilai berikut:
| Menampilkan kode | Deskripsi |
|---|---|
| STATUS_SUCCESS | Sistem file berhasil menyimpan informasi keamanan file yang diminta. |
| STATUS_INSUFFICIENT_RESOURCES | FltRequestSecurityInfoOnCreateCompletion tidak dapat mengalokasikan memori yang cukup untuk menyimpan informasi file yang diminta. |
| STATUS_INVALID_PARAMETER_2 | Objek data panggilan balik yang disediakan bukan operasi pembuatan berbasis IRP. |
Keterangan
Minifilter dapat mengambil informasi file dengan memanggil FltRetrieveFileInfoOnCreateCompletionEx atau FltRetrieveFileInfoOnCreateCompletion selama pembuatan posting. Performa minifilter biasanya lebih baik ketika meminta dan mengambil informasi file dengan cara ini, daripada mengkueri informasi file di lain waktu.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 11, versi 24H2 |
| Header | fltkernel.h (termasuk Fltkernel.h) |