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 次の 1 つ以上の組み合わせとして設定する情報を指定する値です。

値	説明
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 ベースの作成操作ではありません。

注釈

ミニフィルターは、作成後に FltRetrieveFileInfoOnCreateCompletionEx または FltRetrieveFileInfoOnCreateCompletion を呼び出すことによって、ファイル情報を取得できます。 ミニフィルターのパフォーマンスは、通常、後でファイル情報に対してクエリを実行するのではなく、この方法でファイル情報を要求および取得する場合に優れています。

要件

要件	値
サポートされている最小のクライアント	Windows 11バージョン 24H2
Header	fltkernel.h (Fltkernel.h を含む)

こちらもご覧ください

FltRetrieveFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx