ZwQueryQuotaInformationFile-Funktion (ntifs.h)

Artikel
12/21/2024

Die ZwQueryQuotaInformationFile Routine ruft Kontingenteinträge ab, die dem vom FileHandle Parameter angegebenen Volume zugeordnet sind.

Syntax

NTSYSAPI NTSTATUS ZwQueryQuotaInformationFile(
  [in]           HANDLE           FileHandle,
  [out]          PIO_STATUS_BLOCK IoStatusBlock,
  [out]          PVOID            Buffer,
  [in]           ULONG            Length,
  [in]           BOOLEAN          ReturnSingleEntry,
  [in, optional] PVOID            SidList,
  [in]           ULONG            SidListLength,
  [in, optional] PSID             StartSid,
  [in]           BOOLEAN          RestartScan
);

Parameter

[in] FileHandle

Ein Handle für das Dateiobjekt, das die Datei oder das Volume darstellt, für die die Kontingentinformationen angefordert werden.

[out] IoStatusBlock

Die Adresse des E/A-Statusblocks des Anrufers.

[out] Buffer

Ein Puffer zum Empfangen der Kontingentinformationen für das Volume. Die Kontingentinformationen werden als eine oder mehrere FILE_QUOTA_INFORMATION Strukturen formatiert. Das feld NextEntryOffset in der FILE_QUOTA_INFORMATION Struktur enthält den Offset (in Byte) des nächsten Kontingenteintrags in der Liste. Wenn nach dem aktuellen keine Einträge mehr vorhanden sind, ist dieses Element null.

[in] Length

Die Länge in Byte des Puffers.

[in] ReturnSingleEntry

Ein boolescher Wert, der angibt, ob nur ein einzelner Eintrag zurückgegeben werden soll, anstatt den Puffer mit so vielen Einträgen wie möglich auszufüllen.

[in, optional] SidList

Eine optionale Liste von SIDs, deren Kontingentinformationen zurückgegeben werden sollen. Jeder Eintrag in der Liste ist eine FILE_GET_QUOTA_INFORMATION Struktur. Das NextEntryOffset Feld in der FILE_GET_QUOTA_INFORMATION-Struktur enthält den Offset (in Byte) des nächsten Kontingenteintrags in der Liste. Wenn nach dem aktuellen keine Einträge mehr vorhanden sind, ist dieses Element null.

[in] SidListLength

Die Länge in Byte der SID- Liste, wenn eine angegeben wurde.

[in, optional] StartSid

Ein optionaler Zeiger auf die SID- des Eintrags, bei dem mit dem Scannen der Kontingentinformationen begonnen werden soll. Dieser Parameter sollte festgelegt werden, wenn die zurückgegebenen Informationen mit einem anderen Eintrag als der ersten SID beginnen sollen. Dieser Parameter wird ignoriert, wenn ein SidList Parameter angegeben wird.

[in] RestartScan

Ein boolescher Wert, der angibt, ob die Überprüfung der Kontingentinformationen von Anfang an neu gestartet werden soll. Legen Sie diesen Parameter auf TRUE fest, wenn die Überprüfung der Kontingentinformationen beim ersten Eintrag in der Kontingentinformationsliste des Volumes beginnen soll. Wird auf FALSE- festgelegt, wenn der Scan von einem vorherigen Aufruf an ZwQueryQuotaInformationFilefortgesetzt wird. Der Aufrufer muss diesen Parameter beim erstmaligen Aufruf ZwQueryQuotaInformationFile-auf TRUE festlegen.

Rückgabewert

Die ZwQueryQuotaInformationFile- Routine gibt STATUS_SUCCESS zurück, wenn mindestens eine FILE_QUOTA_INFORMATION Struktur im parameter Buffer oder einem entsprechenden NTSTATUS-Wert wie einem der folgenden zurückgegeben wird:

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Es waren unzureichende Ressourcen vorhanden, um den Vorgang abzuschließen. Dies ist ein Fehlercode.
STATUS_INVALID_DEVICE_REQUEST	Kontingente sind auf dem Volume nicht aktiviert. Dies ist ein Fehlercode.
STATUS_INVALID_SID	Der parameter StartSid enthält keine gültige SID-. Dies ist ein Fehlercode.
STATUS_QUOTA_LIST_INCONSISTENT	Der SidList Parameter enthielt keine gültige, ordnungsgemäß formatierte Liste. Dies ist ein Fehlercode.

Bemerkungen

Die Menge der von ZwQueryQuotaInformationFile zurückgegebenen Informationen basiert auf der Größe der dem Volume zugeordneten Kontingentinformationen, der Größe des Puffers und ob eine bestimmte Menge von Einträgen angefordert wurde.

Ein Aufruf von ZwQueryQuotaInformationFile führt dazu, dass eine IRP_MJ_SET_QUOTA Anforderung an das Geräteobjekt gesendet wird, das dem Dateiobjekt zugeordnet ist, dessen Handle im FileHandle Parameter gespeichert ist.

Wenn das zugrunde liegende Dateisystem Kontingentinformationen (z. B. FAT- und CDFS-Dateisysteme) nicht unterstützt, schlägt ZwQueryQuotaInformationFile fehl, wenn STATUS_INVALID_DEVICE_REQUEST zurückgegeben werden.

Anmerkung

Wenn der Aufruf der ZwQueryQuotaInformationFile Funktion im Benutzermodus auftritt, sollten Sie den Namen "NtQueryQuotaInformationFile" anstelle von "ZwQueryQuotaInformationFile" verwenden.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx und ZwXxx- Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter behandeln und interpretieren. Weitere Informationen zur Beziehung zwischen den NtXxx und ZwXxx- Versionen einer Routine finden Sie unter Using Nt and Zw Versions of the Native System Services Routines.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 7
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h, FltKernel.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)