共用方式為

FltQueryEaFile 函式 （fltkernel.h）

  • 發行項

FltQueryEaFile 會傳回檔案擴充屬性 （EA） 值的相關信息。

語法

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

參數

[in] Instance

要傳送 QueryEa 作業之迷你篩選驅動程序實例的不透明實例指標。 實例必須附加至檔案所在的磁碟區。

[in] FileObject

檔案的檔案對象指標。

[out] ReturnedEaData

要傳回擴充屬性值之呼叫端提供的 FILE_FULL_EA_INFORMATION結構化輸入緩衝區指標。

[in] Length

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

[in] ReturnSingleEntry

如果 FltQueryEaFile 應該只傳回找到的第一個專案，請將 設定 為 true。

[in, optional] EaList

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

[in] EaListLength

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

[in, optional] EaIndex

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

[in] RestartScan

如果 FltQueryEaFile 應該在檔案的 extended-attribute 清單中第一個專案開始掃描，請將 設定 為 true。 如果此參數未設定為 true ，則會從先前 呼叫 fltQueryEaFile繼續掃描。

[out, optional] LengthReturned

呼叫端配置的變數指標，接收 ReturnedEaData 緩衝區中傳回的資訊大小，以位元組為單位。 這個參數是選擇性的，而且可以 NULL。

傳回值

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

傳回碼 描述
STATUS_EAS_NOT_SUPPORTED
 檔案系統不支援擴充屬性。 這是錯誤碼。
STATUS_FLT_DELETING_OBJECT
 實例或磁碟區正在被拆毀。 這是錯誤碼。
STATUS_INSUFFICIENT_RESOURCES
 FltQueryEaFile 發生集區配置失敗。 這是錯誤碼。

要求

要求 價值
最低支援的用戶端 適用於 SP4、Windows XP SP3、Windows Server 2003 SP1 和更新版本的 Windows作系統Microsoft Windows 2000 更新匯總 1。
目標平臺 普遍
標頭 fltkernel.h （包括 Fltkernel.h）
連結庫 FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

另請參閱

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile

IoCheckEaBufferValidity