次の方法で共有

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 がファイルの extended-attribute リストの最初のエントリでスキャンを開始する必要がある場合は、TRUE に設定します。 このパラメーターが TRUE に設定されていない場合、 FltQueryEaFile の以前の呼び出しからスキャンが再開されます。

[out, optional] LengthReturned

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

戻り値

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

リターン コード 説明
STATUS_EAS_NOT_SUPPORTED
 ファイル システムは拡張属性をサポートしていません。 これはエラー コードです。
STATUS_FLT_DELETING_OBJECT
 インスタンスまたはボリュームが破棄されています。 これはエラー コードです。
STATUS_INSUFFICIENT_RESOURCES
 FltQueryEaFile で プール割り当てエラーが発生しました。 これはエラー コードです。

要件

要件 値
サポートされている最小のクライアント Microsoft Windows 2000 Update Rollup 1 for SP4、Windows XP SP3、Windows Server 2003 SP1、およびそれ以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム ユニバーサル
Header fltkernel.h (Fltkernel.h を含む)
Library FltMgr.lib
[DLL] Fltmgr.sys
IRQL PASSIVE_LEVEL

こちらもご覧ください

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile

IoCheckEaBufferValidity