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 應該在檔案擴充屬性清單中的第一個專案開始掃描，請將 設定為 TRUE。 如果此參數未設定為 TRUE，則會從先前呼叫 FltQueryEaFile 繼續掃描。

[out, optional] LengthReturned

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

傳回值

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

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

規格需求

需求	值
最低支援的用戶端	適用於 SP4、Windows XP SP3、Windows Server 2003 SP1 和更新版本的 Windows 操作系統的 Microsoft Windows 2000 Update 匯總 1。
目標平台	Universal
標頭	fltkernel.h (包含 Fltkernel.h)
程式庫	FltMgr.lib
Dll	Fltmgr.sys
IRQL	PASSIVE_LEVEL

另請參閱

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile

IoCheckEaBufferValidity