共用方式為

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 緩衝區指向的EA清單未正確格式化。 這是錯誤碼。
STATUS_INSUFFICIENT_RESOURCES 記憶體不足，無法完成作業。 這是錯誤碼。

備註

ZwSetEaFile 會將 與 FileHandle 相關聯的 EA 取代為 Buffer 所指向緩衝區中的 EA。 緩衝區中的 EA 必須格式化為 一連串FILE_FULL_EA_INFORMATION 結構。 ZwSetEaFile 會 先 檢查 EA 值的緩衝區是否有效 ，然後再取代現有的 EA。

規格需求

需求 值
最低支援的用戶端 Windows 2000
目標平台 Universal
標頭 ntifs.h (包含 FltKernel.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm)

另請參閱

FILE_FULL_EA_INFORMATION

IoCheckEaBufferValidity

ZwQueryEaFile