共用方式為

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)

另請參閱

FltRetrieveFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx