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