FltRequestSecurityInfoOnCreateCompletion 函式 (fltkernel.h)
小型篩選程式會在檔案預先建立期間呼叫 FltRequestSecurityInfoOnCreateCompletion,要求文件系統在建立後儲存檔案安全性資訊以進行擷取。
語法
NTSTATUS FLTAPI FltRequestSecurityInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
SECURITY_INFORMATION SecurityInformation
);
參數
Filter
可唯一識別迷你篩選驅動程式的不透明篩選指標。
Data
代表 I/O 建立作業之 FLT_CALLBACK_DATA 回呼數據的指標。
SecurityInformation
SECURITY_INFORMATION 值,指定要設定為下列一或多個組合的資訊。
價值 | 意義 |
---|---|
OWNER_SECURITY_INFORMATION | 表示要設定對象的擁有者標識碼。 需要WRITE_OWNER存取權。 |
GROUP_SECURITY_INFORMATION | 表示要設定物件的主要群組標識碼。 需要WRITE_OWNER存取權。 |
DACL_SECURITY_INFORMATION | 表示要設定物件的任意訪問控制清單 (DACL)。 需要WRITE_DAC存取權。 |
SACL_SECURITY_INFORMATION | 表示要設定物件的系統 ACL (SACL)。 需要ACCESS_SYSTEM_SECURITY存取權。 |
傳回值
FltRequestSecurityInfoOnCreateCompletion 可以傳回下列其中一個值:
傳回碼 | 描述 |
---|---|
STATUS_SUCCESS | 檔系統已成功儲存要求的檔案安全性資訊。 |
STATUS_INSUFFICIENT_RESOURCES | FltRequestSecurityInfoOnCreateCompletion 無法配置足夠的記憶體來儲存所要求的檔案資訊。 |
STATUS_INVALID_PARAMETER_2 | 提供的回呼數據物件不是以 IRP 為基礎的建立作業。 |
言論
minifilter 可以呼叫 FltRetrieveFileInfoOnCreateCompletionEx 或 FltRetrieveFileInfoOnCreateCompletion 來擷取檔案資訊。 小型篩選程式的效能通常會在要求和擷取以這種方式擷取檔案資訊時更好,而不是稍後查詢檔案資訊。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 11 版本 24H2 |
標頭 | fltkernel.h (包括 Fltkernel.h) |