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クエリ対象の CA を指定する構造化入力バッファーへのポインター。 このパラメーターは省略可能であり、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 がバッファーに書き込まれるか、バッファーにすべての CA を格納するのに十分な大きさでない場合は、完全な EA が格納されます。 完全な EA のみがバッファーに書き込まれます。部分 EA は返されません。

必要条件

関連項目

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile