Fungsi FltRetrieveFileInfoOnCreateCompletion (fltkernel.h)

Artikel
05/23/2024

FltRetrieveFileInfoOnCreateCompletion mengambil informasi file yang diminta selama pembuatan postingan file. Gunakan FltRetrieveFileInfoOnCreateCompletionEx untuk mendapatkan kode NTSTATUS bersama dengan informasi yang diminta.

Sintaks

PVOID FLTAPI FltRetrieveFileInfoOnCreateCompletion(
  [in]  PFLT_FILTER        Filter,
  [in]  PFLT_CALLBACK_DATA Data,
  [in]  ULONG              InfoClass,
  [out] PULONG             Size
);

Parameter

[in] Filter

Penunjuk filter buram yang secara unik mengidentifikasi driver minifilter.

[in] Data

Arahkan ke data panggilan balik FLT_CALLBACK_DATA yang mewakili operasi I/O.

[in] InfoClass

Bendera yang menunjukkan jenis informasi yang akan dikembalikan. Perhatikan bahwa bendera tidak dapat digabungkan. Dapat berupa salah satu dari nilai berikut:

Bendera	Makna
QoCFileStatInformation (0x00000001)	Sistem file akan mengembalikan informasi statistik file dalam struktur QUERY_ON_CREATE_FILE_STAT_INFORMATION .
QoCFileLxInformation (0x00000002)	Sistem file akan mengembalikan informasi seperti Linux yang diperluas dalam struktur QUERY_ON_CREATE_FILE_LX_INFORMATION .
QoCFileEaInformation (0x00000004)	Sistem file akan mengembalikan atribut yang diperluas (EA) dalam struktur QUERY_ON_CREATE_EA_INFORMATION .
QoCFileUsnInformation (0x00000008)	Sistem file akan mengembalikan informasi USN dalam struktur QUERY_ON_CREATE_USN_INFORMATION .
QoCFileSecurityInformation (0x00000010)	Sistem file akan mengembalikan informasi keamanan file dalam struktur QUERY_ON_CREATE_SECURITY_INFORMATION .

[out] Size

Penunjuk ke ULONG yang menentukan ukuran, dalam byte, dari buffer yang dikembalikan fungsi ini.

Nilai kembali

FltRetrieveFileInfoOnCreateCompletion mengembalikan pointer ke buffer dengan informasi file yang diminta. Struktur dalam buffer ditentukan oleh nilai InfoClass. Jika sistem file memproses permintaan tetapi tidak dapat menemukan informasi file yang diminta, parameter ini diatur ke NULL.

Keterangan

Minifilter harus memanggil FltRequestFileInfoOnCreateCompletion selama pra-buat file untuk menentukan informasi file mana yang harus dilacak oleh sistem file.