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 可以傳回下列其中一個值:
傳回碼 | Description |
---|---|
STATUS_SUCCESS | 檔系統已成功儲存要求的檔案安全性資訊。 |
STATUS_INSUFFICIENT_RESOURCES | FltRequestSecurityInfoOnCreateCompletion 無法配置足夠的記憶體來儲存要求的檔案資訊。 |
STATUS_INVALID_PARAMETER_2 | 提供的回呼數據物件不是以 IRP 為基礎的建立作業。 |
備註
minifilter 可以在建立後呼叫 FltRetrieveFileInfoOnCreateCompletionEx 或 FltRetrieveFileInfoOnCreateCompletion 來擷取檔案資訊。 迷你篩選的效能通常比較好,因為它會以這種方式要求和擷取檔案資訊,而不是稍後查詢檔案資訊。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 11 版本 24H2 |
標頭 | fltkernel.h (包含 Fltkernel.h) |