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) |