ZwQueryEaFile 函式 (ntifs.h)

ZwQueryEaFile 例程會傳回檔案的擴充屬性 (EA) 值的相關信息。

語法

NTSTATUS ZwQueryEaFile(
  [in]           HANDLE           FileHandle,
  [out]          PIO_STATUS_BLOCK IoStatusBlock,
  [out]          PVOID            Buffer,
  [in]           ULONG            Length,
  [in]           BOOLEAN          ReturnSingleEntry,
  [in, optional] PVOID            EaList,
  [in]           ULONG            EaListLength,
  [in, optional] PULONG           EaIndex,
  [in]           BOOLEAN          RestartScan
);

參數

[in] FileHandle

要在其中執行作業之檔案的句柄。

[out] IoStatusBlock

接收最終完成狀態 的IO_STATUS_BLOCK 結構的指標，以及所要求作業的其他資訊。

[out] Buffer

呼叫端提供的 FILE_FULL_EA_INFORMATION結構化輸出緩衝區指標，其中會傳回擴充屬性值。

[in] Length

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

[in] ReturnSingleEntry

如果 ZwQueryEaFile 應該只傳回找到的第一個專案，則設定為 TRUE。

[in, optional] EaList

呼叫端提供的 FILE_GET_EA_INFORMATION結構化輸入緩衝區指標，指定要查詢的擴充屬性。 這個參數是選擇性的，而且可以是 NULL。

[in] EaListLength

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

[in, optional] EaIndex

掃描檔案擴充屬性清單的專案索引應該開始。 如果 EaList 參數指向無空清單，則會忽略此參數。 這個參數是選擇性的，而且可以是 NULL。

[in] RestartScan

如果 ZwQueryEaFile 應該在檔案擴充屬性清單中的第一個專案開始掃描，則設定為 TRUE。 如果此參數設定為 FALSE，則例程會從先前對 ZwQueryEaFile 的呼叫繼續掃描。

傳回值

ZwQueryEaFile 會 傳回STATUS_SUCCESS 或適當的 NTSTATUS 值，如下所示：

傳回值	描述
STATUS_EAS_NOT_SUPPORTED	檔案系統不支援擴充屬性。 這是錯誤碼。
STATUS_INSUFFICIENT_RESOURCES	ZwQueryEaFile 例程發生集區配置失敗。 這是錯誤碼。
STATUS_EA_LIST_INCONSISTENT	EaList 參數的格式不正確。 這是錯誤碼。

規格需求

需求	值
最低支援的用戶端	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

FILE_GET_EA_INFORMATION

ZwSetEaFile