共用方式為

FsRtlQueryKernelEaFile 函式 （ntifs.h）

  • 發行項

FsRtlQueryKernelEaFile 例程可用來建置明確的 QueryEA 要求，並同步等候它完成，並傳回結果。 這可讓呼叫端透過 FileObject 執行這項操作，而不是句柄。

語法

NTSTATUS FsRtlQueryKernelEaFile(
  [in]            PFILE_OBJECT FileObject,
  [out]           PVOID        ReturnedEaData,
  [in]            ULONG        Length,
  [in]            BOOLEAN      ReturnSingleEntry,
  [in]            PVOID        EaList,
  [in]            ULONG        EaListLength,
  [in, optional]  PULONG       EaIndex,
  [in]            BOOLEAN      RestartScan,
  [out, optional] PULONG       LengthReturned
);

參數

[in] FileObject

要傳送 QueryEA 要求的 FileObject 指標。

[out] ReturnedEaData

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

[in] Length

指定 returnedEaData 的長度，以位元組為單位

[in] ReturnSingleEntry

指定是否應該只傳回單一專案，而不是盡可能填滿緩衝區。

[in] EaList

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

[in] EaListLength

指定提供EA清單時，EaList長度。

[in, optional] EaIndex

提供要傳回其值之EA的選擇性索引。 如果指定，則只會傳回該 EA。

[in] RestartScan

指定是否應該從頭重新啟動 EA 掃描。

[out, optional] LengthReturned

指定 ReturnedEaData 緩衝區中傳回的有效數據量。

傳回值

FsRtlQueryKernelEaFile 例程會傳回其中一個狀態代碼：

傳回碼 描述
STATUS_EAS_NOT_SUPPORTED
檔案系統不支援擴充屬性。
STATUS_INVALID_DEVICE_REQUEST
 要求因為直接裝置已開啟而失敗。
STATUS_INSUFFICIENT_RESOURCES
 無法為此要求配置 I/O 要求封包 （IRP）。
STATUS_SUCCESS
 要求成功。

言論

此例程 FsRtlQueryKernelEaFile 假設所有傳入的緩衝區都是來自核心模式，因為它需要指定的輸入和輸出緩衝區，如果指定，則為核心模式位址。 如果指定使用者模式位址，作業將會失敗。

要求

要求 價值
最低支援的用戶端 Windows 8
支援的最低伺服器 Windows Server 2012
目標平臺 窗戶
標頭 ntifs.h

另請參閱

FsRtlSetKernelEaFile

ZwQueryEaFile

ZwSetEaFile