FltRetrieveFileInfoOnCreateCompletion 函式 (fltkernel.h)
FltRetrieveFileInfoOnCreateCompletion 在建立檔案期間擷取要求的檔案資訊。 使用 FltRetrieveFileInfoOnCreateCompletionEx 來取得 NTSTATUS 程式代碼以及要求的資訊。
語法
PVOID FLTAPI FltRetrieveFileInfoOnCreateCompletion(
[in] PFLT_FILTER Filter,
[in] PFLT_CALLBACK_DATA Data,
[in] ULONG InfoClass,
[out] PULONG Size
);
參數
[in] Filter
可唯一識別迷你篩選驅動程式的不透明篩選指標。
[in] Data
代表 I/O 作業之 FLT_CALLBACK_DATA 回呼數據的指標。
[in] InfoClass
旗標,表示要傳回的信息類型。 請注意,無法合併旗標。 可以是下列其中一個值:
旗 | 意義 |
---|---|
QoCFileStatInformation (0x00000001) | 檔系統會在 QUERY_ON_CREATE_FILE_STAT_INFORMATION 結構中傳回檔案統計數據資訊。 |
QoCFileLxInformation (0x00000002) | 文件系統會在 QUERY_ON_CREATE_FILE_LX_INFORMATION 結構中傳回類似 Linux 的擴充資訊。 |
QoCFileEaInformation (0x00000004) | 檔系統會在 QUERY_ON_CREATE_EA_INFORMATION 結構中傳回擴充屬性 (EA)。 |
QoCFileUsnInformation (0x00000008) | 檔系統會在 QUERY_ON_CREATE_USN_INFORMATION 結構中傳回 USN 資訊。 |
QoCFileSecurityInformation (0x00000010) | 檔系統會在 QUERY_ON_CREATE_SECURITY_INFORMATION 結構中傳回檔案安全性資訊。 |
[out] Size
ULONG 的指標,指定這個函式傳回之緩衝區的大小,以位元組為單位。
傳回值
FltRetrieveFileInfoOnCreateCompletion 傳回具有所要求檔案信息的緩衝區指標。 緩衝區內的 結構是由 InfoClass的值所決定。 如果文件系統處理要求但找不到要求的檔案資訊,此參數會設定為NULL。
言論
小型篩選程式必須在檔案預先建立期間呼叫 FltRequestFileInfoOnCreateCompletion,以指定文件系統應該追蹤的檔案資訊。
要求
要求 | 價值 |
---|---|
標頭 | fltkernel.h |