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 値を返します。

注釈

ZwQueryEaFile から返される情報の量は、CA のサイズと Buffer が指すバッファーのサイズに基づきます。 つまり、要求されたすべての EA がバッファーに書き込まれるか、バッファーにすべての EA を含めるのに十分な大きさでない場合は、完全な EA が格納されます。 完全な EA のみがバッファーに書き込まれます。部分 EA は返されません。

要件

こちらもご覧ください

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile