ZwSetEaFile 関数 (ntifs.h)

  • [アーティクル]

ZwSetEaFile は 、ファイルに関連付けられている拡張属性 (EA) を指定した EA に置き換えます。

構文

NTSTATUS ZwSetEaFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PVOID            Buffer,
  [in]  ULONG            Length
);

パラメーター

[in] FileHandle

操作を実行するファイルのハンドル。

[out] IoStatusBlock

最終的 な完了 状態と、要求された操作に関するその他の情報を受け取るIO_STATUS_BLOCK構造体へのポインター。

[in] Buffer

ファイルに現在関連付けられている EA を置き換える新しい EA を含む、呼び出し元から提供された FILE_FULL_EA_INFORMATION構造化入力バッファーへのポインター。

[in] Length

Buffer パラメーターが指すバッファーの長さ (バイト単位)。

戻り値

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

戻り値 説明
STATUS_EA_LIST_INCONSISTENT Buffer が指す EA リストが正しく書式設定されていません。 これはエラー コードです。
STATUS_INSUFFICIENT_RESOURCES 操作を完了するのに十分なメモリがありません。 これはエラー コードです。

注釈

ZwSetEaFile は、 FileHandle に関連付けられている EA を 、Buffer が指すバッファー内の EA に置き換えます。 バッファー内の EA は、 FILE_FULL_EA_INFORMATION 構造体のシーケンスとして書式設定する必要があります。 ZwSetEaFile は、最初 に 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)

こちらもご覧ください

FILE_FULL_EA_INFORMATION

IoCheckEaBufferValidity

ZwQueryEaFile