FltQueryQuotaInformationFile-Funktion (fltkernel.h)

Artikel
02/29/2024

Die FltQueryQuotaInformationFile-Routine ruft Kontingenteinträge ab, die einem Dateiobjekt zugeordnet sind.

Syntax

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

Ein undurchsichtiger instance Zeiger für den Aufrufer. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[in] FileObject

Ein Dateiobjektzeiger für eine geöffnete Datei, ein Verzeichnis, ein Speichergerät oder ein Volume. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[out] IoStatusBlock

Ein vom Aufrufer bereitgestellter IO_STATUS_BLOCK , um das Ergebnis des Aufrufs von FltQueryQuotaInformationFile zu empfangen. Wenn der Aufruf aufgrund einer ungültigen SID-Liste fehlschlägt, enthält das Feld Information den Speicherort in SidList , an dem der Fehler aufgetreten ist.

[out] Buffer

Ein Zeiger auf einen vom Aufrufer bereitgestellten FILE_GET_QUOTA_INFORMATION strukturierten Eingabepuffer, in dem die Kontingentinformationswerte zurückgegeben werden sollen.

[in] Length

Die Länge des Puffers in Bytes, auf den der Buffer-Parameter verweist.

[in] ReturnSingleEntry

Legen Sie auf TRUE fest, wenn FltQueryQuotaInformationFile nur den ersten gefundenen Eintrag zurückgeben soll.

[in, optional] SidList

Ein Zeiger auf einen vom Aufrufer bereitgestellten FILE_GET_QUOTA_INFORMATION strukturierten Eingabepuffer, der die abzufragten Kontingentinformationen angibt. Dieser Parameter ist optional und kann NULL sein.

[in] SidListLength

Die Länge des Puffers in Bytes, auf den der SidList-Parameter verweist.

[in, optional] StartSid

Der Index des Eintrags, an dem mit der Überprüfung der Kontingentinformationsliste der Datei begonnen werden soll. Dieser Parameter wird ignoriert, wenn der SidList-Parameter auf eine nicht erlösende Liste verweist. Dieser Parameter ist optional und kann NULL sein.

[in] RestartScan

Legen Sie auf TRUE fest, wenn FltQueryQuotaInformationFile mit der Überprüfung am ersten Eintrag in der Kontingentinformationsliste der Datei beginnen soll. Wenn dieser Parameter nicht auf TRUE festgelegt ist, wird der Scan von einem vorherigen Aufruf von FltQueryQuotaInformationFile fortgesetzt.

[out, optional] LengthReturned

Ein Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Größe der im Puffer zurückgegebenen Informationen in Bytes empfängt. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

FltQueryQuotaInformationFile gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert wie den folgenden zurück.

Rückgabecode	Beschreibung
STATUS_FLT_DELETING_OBJECT	Das instance oder Volume wird abgerissen. Dies ist ein Fehlercode.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Universell
Header	fltkernel.h (include Fltkernel.h)
Bibliothek	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Weitere Informationen

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile

Freigeben über