FsRtlQueryKernelEaFile 関数 (ntifs.h)

  • [アーティクル]

ルーチン FsRtlQueryKernelEaFile は、明示的な QueryEA 要求を作成し、完了するまで同期的に待機し、結果を返すために使用されます。 これにより、呼び出し元はハンドルではなく FileObject によってこれを行うことができます。

構文

NTSTATUS FsRtlQueryKernelEaFile(
  [in]            PFILE_OBJECT FileObject,
  [out]           PVOID        ReturnedEaData,
  [in]            ULONG        Length,
  [in]            BOOLEAN      ReturnSingleEntry,
  [in]            PVOID        EaList,
  [in]            ULONG        EaListLength,
  [in, optional]  PULONG       EaIndex,
  [in]            BOOLEAN      RestartScan,
  [out, optional] PULONG       LengthReturned
);

パラメーター

[in] FileObject

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

[out] ReturnedEaData

呼び出し元から提供された FILE_FULL_EA_INFORMATION構造化された出力バッファーへのポインター。拡張属性値が返されます。

[in] Length

ReturnedEaData の長さをバイト単位で指定します

[in] ReturnSingleEntry

バッファーにできるだけ多くの EA を入力するのではなく、1 つのエントリのみを返す必要があるかどうかを指定します。

[in] EaList

クエリ対象の拡張属性を指定する、呼び出し元から提供された FILE_GET_EA_INFORMATION構造化入力バッファーへのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。

[in] EaListLength

EA リストが指定されている場合は、 EaList の長さを指定します。

[in, optional] EaIndex

値が返される EA のオプションのインデックスを提供します。 指定した場合、その EA のみが返されます。

[in] RestartScan

CA のスキャンを最初から再起動するかどうかを指定します。

[out, optional] LengthReturned

ReturnedEaData バッファーで返される有効なデータの量を指定します。

戻り値

ルーチン FsRtlQueryKernelEaFile は、次のいずれかの状態コードを返します。

リターン コード 説明
STATUS_EAS_NOT_SUPPORTED
ファイル システムは拡張属性をサポートしていません。
STATUS_INVALID_DEVICE_REQUEST
 直接デバイスが開いていたため、要求は失敗しました。
STATUS_INSUFFICIENT_RESOURCES
 この要求に I/O 要求パケット (IRP) を割り当てませんでした。
STATUS_SUCCESS
 要求は成功しました。

注釈

このルーチン FsRtlQueryKernelEaFile は、指定された入力バッファーと出力バッファーが指定されている場合はカーネル モード アドレスである必要があるため、バッファーで渡されるすべてのがカーネル モードであることを前提としています。 ユーザー モード アドレスが指定されている場合、操作は失敗します。

要件

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

こちらもご覧ください

FsRtlSetKernelEaFile

ZwQueryEaFile

ZwSetEaFile