Fungsi FltQueryQuotaInformationFile (fltkernel.h)

Rutinitas FltQueryQuotaInformationFile mengambil entri kuota yang terkait dengan objek file.

Sintaks

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
);

Parameter

[in] Instance

Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

[in] FileObject

Penunjuk objek file untuk file terbuka, direktori, perangkat penyimpanan, atau volume. Parameter ini diperlukan dan tidak boleh NULL.

[out] IoStatusBlock

Penelepon yang disediakan IO_STATUS_BLOCK untuk menerima hasil panggilan ke FltQueryQuotaInformationFile. Jika panggilan gagal karena daftar SID yang tidak valid, bidang Informasi akan berisi lokasi di SidList tempat kesalahan terjadi.

[out] Buffer

Penunjuk ke buffer input terstruktur FILE_GET_QUOTA_INFORMATION yang disediakan penelepon tempat nilai informasi kuota akan dikembalikan.

[in] Length

Panjang, dalam byte, dari buffer yang dirujuk oleh parameter Buffer .

[in] ReturnSingleEntry

Atur ke TRUE jika FltQueryQuotaInformationFile hanya akan mengembalikan entri pertama yang ditemukan.

[in, optional] SidList

Penunjuk ke buffer input terstruktur FILE_GET_QUOTA_INFORMATION yang disediakan penelepon yang menentukan informasi kuota yang akan dikueri. Parameter ini bersifat opsional dan dapat berupa NULL.

[in] SidListLength

Panjang, dalam byte, dari buffer yang dituju parameter SidList .

[in, optional] StartSid

Indeks entri untuk mulai memindai daftar informasi kuota file. Parameter ini diabaikan jika parameter SidList menunjuk ke daftar yang tidak kosong. Parameter ini bersifat opsional dan dapat berupa NULL.

[in] RestartScan

Atur ke TRUE jika FltQueryQuotaInformationFile harus memulai pemindaian pada entri pertama dalam daftar informasi kuota file. Jika parameter ini tidak diatur ke TRUE, pemindaian dilanjutkan dari panggilan sebelumnya ke FltQueryQuotaInformationFile.

[out, optional] LengthReturned

Penunjuk ke variabel yang dialokasikan penelepon yang menerima ukuran, dalam byte, dari informasi yang dikembalikan di Buffer. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

FltQueryQuotaInformationFile mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti berikut ini.

Menampilkan kode	Deskripsi
STATUS_FLT_DELETING_OBJECT	Instans atau volume sedang dirundung. Ini adalah kode kesalahan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 8.
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Lihat juga

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile