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 |
|---|---|
|
檔案系統不支援擴充屬性。 這是錯誤碼。 |
|
實例或磁碟區正在損毀。 這是錯誤碼。 |
|
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 |