FltQueryQuotaInformationFile 函式 (fltkernel.h)
FltQueryQuotaInformationFile 例程會擷取與檔案對象相關聯的配額專案。
語法
NTSTATUS FLTAPI FltQueryQuotaInformationFile(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[out] PVOID Buffer,
[in] ULONG Length,
[in] BOOLEAN ReturnSingleEntry,
[in, optional] PVOID SidList,
[in] ULONG SidListLength,
[in, optional] PULONG StartSid,
[in] BOOLEAN RestartScan,
[out, optional] PULONG LengthReturned
);
參數
[in] Instance
呼叫端的不透明實例指標。 這個參數是必要的，而且不能是 NULL。
[in] FileObject
開啟檔案、目錄、儲存裝置或磁碟區的檔案物件指標。 這個參數是必要的，而且不能是 NULL。
[out] IoStatusBlock
呼叫端提供的 IO_STATUS_BLOCK ，以接收 FltQueryQuotaInformationFile 呼叫的結果。 如果呼叫因無效 的 SID 清單而失敗， [資訊 ] 欄位將會包含發生錯誤的 SidList 中的位置。
[out] Buffer
呼叫端提供的 FILE_GET_QUOTA_INFORMATION結構化輸入緩衝區指標，其中要傳回配額資訊值。
[in] Length
Buffer 參數指向的緩衝區長度，以位元組為單位。
[in] ReturnSingleEntry
如果 FltQueryQuotaInformationFile 應該只傳回找到的第一個專案，則設定為 TRUE。
[in, optional] SidList
呼叫端提供的 FILE_GET_QUOTA_INFORMATION結構化輸入緩衝區指標，指定要查詢的配額資訊。 這個參數是選擇性的，而且可以是 NULL。
[in] SidListLength
SidList 參數指向的緩衝區長度，以位元組為單位。
[in, optional] StartSid
開始掃描檔案配額資訊清單之專案的索引。 如果 SidList 參數指向無空清單，則會忽略此參數。 這個參數是選擇性的，而且可以是 NULL。
[in] RestartScan
如果 FltQueryQuotaInformationFile 應該在檔案配額資訊清單中的第一個專案開始掃描，則設定為 TRUE。 如果此參數未設定為 TRUE，則會從先前對 FltQueryQuotaInformationFile 的呼叫繼續掃描。
[out, optional] LengthReturned
呼叫端配置的變數指標，可接收 Buffer 中傳回之資訊的大小，以位元組為單位。 這個參數是選擇性的，而且可以是 NULL。
傳回值
FltQueryQuotaInformationFile 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，如下所示。
| 傳回碼 | Description |
|---|---|
|
實例或磁碟區正在損毀。 這是錯誤碼。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8 開始提供。 |
| 目標平台 | Universal |
| 標頭 | fltkernel.h (包含 Fltkernel.h) |
| 程式庫 | FltMgr.lib |
| Dll | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |