ZwQueryQuotaInformationFile-Funktion (ntifs.h)

Artikel
02/29/2024

Die ZwQueryQuotaInformationFile-Routine ruft Kontingenteinträge ab, die dem durch den 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 das die Kontingentinformationen angefordert werden.

[out] IoStatusBlock

Die Adresse des E/A-status-Blocks des Aufrufers.

[out] Buffer

Ein Puffer zum Empfangen der Kontingentinformationen für das Volume. Die Kontingentinformationen sind als mindestens eine FILE_QUOTA_INFORMATION-Strukturen formatiert. Das Feld NextEntryOffset in der FILE_QUOTA_INFORMATION-Struktur enthält den Offset des nächsten Kontingenteintrags in der Liste in Bytes. Wenn nach dem aktuellen keine weiteren Einträge vorhanden sind, ist dieser Member 0.

[in] Length

Die Länge des Puffers in Bytes.

[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 zu fü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 Feld NextEntryOffset in der FILE_GET_QUOTA_INFORMATION-Struktur enthält den Offset des nächsten Kontingenteintrags in der Liste in Bytes. Wenn nach dem aktuellen keine weiteren Einträge vorhanden sind, ist dieser Member 0.

[in] SidListLength

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

[in, optional] StartSid

Ein optionaler Zeiger auf die SID des Eintrags, an 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 der Scan der Kontingentinformationen von Anfang an neu gestartet werden soll. Legen Sie diesen Parameter auf TRUE fest, wenn der Scan der Kontingentinformationen beim ersten Eintrag in der Liste der Kontingentinformationen des Volumes gestartet werden soll. Legen Sie auf FALSE fest, wenn Sie den Scan aus einem vorherigen Aufruf von ZwQueryQuotaInformationFile fortsetzen. Der Aufrufer muss diesen Parameter auf TRUE festlegen, wenn er ZwQueryQuotaInformationFile zum ersten Mal aufruft.

Rückgabewert

Die ZwQueryQuotaInformationFile-Routine gibt STATUS_SUCCESS zurück, wenn mindestens eine FILE_QUOTA_INFORMATION Struktur im Buffer-Parameter oder ein entsprechender NTSTATUS-Wert wie einer der folgenden zurückgegeben wird:

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Es waren nicht genügend 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 StartSid-Parameter enthielt 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.

Hinweise

Die Menge der von ZwQueryQuotaInformationFile zurückgegebenen Informationen basiert auf der Größe der dem Volume zugeordneten Kontingentinformationen, der Größe des Puffers und der Anforderung eines bestimmten Satz von Einträgen.

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 keine Kontingentinformationen unterstützt (z. B. FAT- und CDFS-Dateisysteme), gibt ZwQueryQuotaInformationFile STATUS_INVALID_DEVICE_REQUEST nicht zurück.

Hinweis

Wenn der Aufruf der ZwQueryQuotaInformationFile-Funktion im Benutzermodus erfolgt, 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, da sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h, FltKernel.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)