FsRtlSetKernelEaFile 関数 (ntifs.h)

  • [アーティクル]

FsRtlQueryKernelEaFile ルーチンを使用して、ファイルの拡張属性 (EA) 値を設定、変更、削除し、同期的に完了するまで待機し、結果を返します。 この API で SecureEA を設定できるようにするIRP_MN_KERNELマイナー コードを設定します。 これにより、呼び出し元はハンドルではなく FileObject によってこれを行うことができます。

構文

NTSTATUS FsRtlSetKernelEaFile(
  [in] PFILE_OBJECT FileObject,
  [in] PVOID        EaBuffer,
  [in] ULONG        Length
);

パラメーター

[in] FileObject

QueryEA 要求を送信する FileObject へのポインター。

[in] EaBuffer

設定する拡張属性値を含む呼び出し元指定 のFILE_FULL_EA_INFORMATION構造化入力バッファーへのポインター

[in] Length

EA バッファーの長さを指定します。

戻り値

ルーチン FsRtlSetKernelEaFile は、操作の状態を受け取り、状態コードのいずれかを返します。

リターン コード 説明
STATUS_EA_LIST_INCONSISTENT
EaList パラメーターの書式が正しくありません。
STATUS_EAS_NOT_SUPPORTED
ファイル システムは拡張属性をサポートしていません。
STATUS_INSUFFICIENT_RESOURCES
 この要求に I/O 要求パケット (IRP) を割り当てませんでした。
STATUS_INTERMIXED_KERNEL_EA_OPERATION
 要求は、同じ呼び出しで通常の EA とカーネル EA を混在させることはできません。
STATUS_INVALID_DEVICE_REQUEST
 直接デバイスが開いていたため、要求は失敗しました。
STATUS_SUCCESS
 要求は成功しました。

注釈

このルーチンは、バッファーで渡されたすべてのがカーネル モードであることを前提としています。

FsRtlSetKernelEaFile の 1 回の呼び出しで、1 つ以上のカーネル EA の設定、変更、削除を行うことができます。 通常の EA は 、FsRtlSetKernelEaFile 関数を使用して設定することもできます。 EA のを削除するには、EaValueLength が 0 の EAName を指定します。 1 回の呼び出しで、新規の挿入、既存の変更、または EA の削除を混在させることができます。

要件

要件 値
サポートされている最小のクライアント Windows 8
サポートされている最小のサーバー Windows Server 2012
対象プラットフォーム Windows
ヘッダー ntifs.h

こちらもご覧ください

FsRtlQueryKernelEaFile

ZwQueryEaFile

ZwSetEaFile