共用方式為

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 值，如下所示。

傳回碼 描述
STATUS_FLT_DELETING_OBJECT
 實例或磁碟區正在被拆毀。 這是錯誤碼。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 普遍
標頭 fltkernel.h （包括 Fltkernel.h）
連結庫 FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

另請參閱

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile