次の方法で共有

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
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ntifs.h

関連項目

FsRtlSetKernelEaFile

ZwQueryEaFile

ZwSetEaFile