共用方式為


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

呼叫端提供的 FILE_FULL_EA_INFORMATION結構化輸入緩衝區指標,其中包含將取代目前與檔案相關聯之 EA 的新 EA。

[in] Length

Buffer 參數指向的緩衝區長度,以位元組為單位。

傳回值

ZwSetEaFile 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值,如下所示:

傳回值 描述
STATUS_EA_LIST_INCONSISTENT Buffer 指向的 EA 清單格式不正確。 這是錯誤碼。
STATUS_INSUFFICIENT_RESOURCES 記憶體不足,無法完成作業。 這是錯誤碼。

言論

ZwSetEaFile 會將與 fileHandle 相關聯的 EA 取代為緩衝區中 緩衝區 指向的 EA。 緩衝區中的 EA 必須格式化為一系列 FILE_FULL_EA_INFORMATION 結構。 ZwSetEaFile檢查 EA 值的緩衝區是否有效,再取代現有的 EA。

要求

要求 價值
最低支援的用戶端 Windows 2000
目標平臺 普遍
標頭 ntifs.h (include FltKernel.h, Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIs(storport)PowerIrpDDis(wdm)

另請參閱

FILE_FULL_EA_INFORMATION

IoCheckEaBufferValidity

ZwQueryEaFile