FltQueryEaFile 関数 (fltkernel.h)

FltQueryEaFile は、ファイルの拡張属性 (EA) 値に関する情報を返します。

構文

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

パラメーター

[in] Instance

QueryEa 操作の送信先となるミニフィルター ドライバー インスタンスの不透明なインスタンス ポインター。 インスタンスは、ファイルが存在するボリュームにアタッチされている必要があります。

[in] FileObject

ファイルのファイル オブジェクト ポインター。

[out] ReturnedEaData

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

[in] Length

ReturnedEaData パラメーターが指すバッファーの長さ (バイト単位)。

[in] ReturnSingleEntry

FltQueryEaFile 見つかった最初のエントリのみを返す必要がある場合は、TRUE を に設定します。

[in, optional] EaList

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

[in] EaListLength

EaList パラメーターが指すバッファーの長さ (バイト単位)。

[in, optional] EaIndex

ファイルの拡張属性リストのスキャンを開始するエントリのインデックス。 EaList パラメーターが空でないリストを指している場合、このパラメーターは無視されます。 このパラメーターは省略可能であり、NULL できます。

[in] RestartScan

FltQueryEaFile ファイルの拡張属性リストの最初のエントリでスキャンを開始する必要がある場合は、TRUE を に設定します。 このパラメーターが TRUE に設定されていない場合は、FltQueryEaFile をする前の呼び出しからスキャンが再開されます。

[out, optional] LengthReturned

returnedEaData バッファーで返される情報のサイズ (バイト単位) を受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは省略可能であり、NULL できます。

戻り値

FltQueryEaFile は、STATUS_SUCCESSまたは次のような適切な NTSTATUS 値を返します。

必要条件

関連項目

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile の

IoCheckEaBufferValidity