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 値を返します。
| リターン コード | 説明 |
|---|---|
|
ファイル システムは拡張属性をサポートしていません。 これはエラー コードです。 |
|
インスタンスまたはボリュームが破棄されています。 これはエラー コードです。 |
|
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 |