ZwQueryEaFile 関数 (ntifs.h)
ZwQueryEaFile ルーチンは、指定されたファイルに関連付けられている拡張属性 (EA) を返します。
構文
NTSTATUS ZwQueryEaFile(
[in] HANDLE FileHandle,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[out] PVOID Buffer,
[in] ULONG Length,
[in] BOOLEAN ReturnSingleEntry,
[in, optional] PVOID EaList,
[in] ULONG EaListLength,
[in, optional] PULONG EaIndex,
[in] BOOLEAN RestartScan
);
パラメーター
[in] FileHandle
操作を実行するファイルのハンドル。
[out] IoStatusBlock
最終的 な完了 状態と、要求された操作に関するその他の情報を受け取るIO_STATUS_BLOCK構造体へのポインター。
[out] Buffer
呼び出し元によって指定された FILE_FULL_EA_INFORMATION構造化された出力バッファーへのポインター。ファイルの EA を返します。
[in] Length
Buffer が指すバッファーの長さ (バイト単位)。
[in] ReturnSingleEntry
ZwQueryEaFile が見つけた最初のエントリのみを返す必要がある場合は TRUE に設定します。
[in, optional] EaList
呼び出し元から提供される FILE_GET_EA_INFORMATION構造化入力バッファーへのポインター。クエリを実行する EA を指定します。 このパラメーターは省略可能であり、NULL にすることができます。
[in] EaListLength
EaList パラメーターが指すバッファーの長さ (バイト単位)。
[in, optional] EaIndex
ファイルの EA リストのスキャンを開始するエントリのインデックス。 EaList が空でないリストを指している場合、このパラメーターは無視されます。 このパラメーターは省略可能であり、NULL にすることができます。
[in] RestartScan
ZwQueryEaFile がファイルの EA リストの最初のエントリでスキャンを開始する必要がある場合は、TRUE に設定します。 このパラメーターが FALSE に設定されている場合、ルーチンは ZwQueryEaFile の以前の呼び出しからスキャンを再開します。
戻り値
ZwQueryEaFile は 、次のようなSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。
戻り値 | 説明 |
---|---|
STATUS_EAS_NOT_SUPPORTED | ファイル システムでは、EA はサポートされていません。 これはエラー コードです。 |
STATUS_INSUFFICIENT_RESOURCES | 操作を完了するのに十分なメモリがありません。 これはエラー コードです。 |
STATUS_EA_LIST_INCONSISTENT | EaList パラメーターの書式が正しくありません。 これはエラー コードです。 |
注釈
ZwQueryEaFile から返される情報の量は、CA のサイズと Buffer が指すバッファーのサイズに基づきます。 つまり、要求されたすべての EA がバッファーに書き込まれるか、バッファーにすべての EA を含めるのに十分な大きさでない場合は、完全な EA が格納されます。 完全な EA のみがバッファーに書き込まれます。部分 EA は返されません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 |
対象プラットフォーム | ユニバーサル |
Header | ntifs.h (FltKernel.h、Ntifs.h を含む) |
Library | NtosKrnl.lib |
[DLL] | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |