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 を含む) |