FltQueryQuotaInformationFile-Funktion (fltkernel.h)

Artikel
02/06/2025

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 Instanzzeiger für den Aufrufer. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in] FileObject

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

[out] IoStatusBlock

Ein vom Aufrufer bereitgestellter IO_STATUS_BLOCK, um das Ergebnis des Aufrufs an FltQueryQuotaInformationFilezu 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, auf den der Buffer Parameter verweist.

[in] ReturnSingleEntry

Wird auf TRUE- festgelegt, 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 zu abfragenden Kontingentinformationen angibt. Dieser Parameter ist optional und kann NULL-werden.

[in] SidListLength

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

[in, optional] StartSid

Der Index des Eintrags, bei dem mit dem Scannen der Kontingentinformationsliste der Datei begonnen werden soll. Dieser Parameter wird ignoriert, wenn der SidList Parameter auf eine nicht leere Liste verweist. Dieser Parameter ist optional und kann NULL-werden.

[in] RestartScan

Auf TRUE- festgelegt, wenn FltQueryQuotaInformationFile- den Scan beim ersten Eintrag in der Kontingentinformationsliste der Datei beginnen soll. Wenn dieser Parameter nicht auf TRUEfestgelegt ist, wird der Scan aus einem vorherigen Aufruf von FltQueryQuotaInformationFilefortgesetzt.

[out, optional] LengthReturned

Ein Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Größe der in Bufferzurückgegebenen Informationen in Byte empfängt. Dieser Parameter ist optional und kann NULL-werden.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_FLT_DELETING_OBJECT	Die Instanz oder das Volume wird heruntergerissen. Dies ist ein Fehlercode.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 8.
Zielplattform-	Universal
Header-	fltkernel.h (include Fltkernel.h)
Library	FltMgr.lib
DLL-	Fltmgr.sys
IRQL-	PASSIVE_LEVEL

Siehe auch

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile-

Freigeben über