ZwSetQuotaInformationFile-Funktion (ntifs.h)

Artikel
12/21/2024

Die ZwSetQuotaInformationFile Routine ändert Kontingenteinträge für das Volume, das dem FileHandle Parameter zugeordnet ist. Alle Kontingenteinträge im angegebenen Puffer werden auf das Volume angewendet.

Syntax

NTSYSAPI NTSTATUS ZwSetQuotaInformationFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PVOID            Buffer,
  [in]  ULONG            Length
);

Parameter

[in] FileHandle

Ein Handle für das Dateiobjekt, das die Datei oder das Volume darstellt, für die die Kontingentinformationen geändert werden sollen.

[out] IoStatusBlock

Die Adresse des E/A-Statusblocks des Anrufers.

[in] Buffer

Ein Puffer mit den neuen Kontingenteinträgen, die auf das Volume angewendet werden sollen. Die Kontingentinformationen müssen als eine oder mehrere FILE_QUOTA_INFORMATION Strukturen formatiert werden. 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.

Rückgabewert

Die ZwSetQuotaInformationFile Routine gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert wie einen der folgenden zurück:

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_MEDIA_WRITE_PROTECTED	Die Lautstärke ist schreibgeschützt. Dies ist ein Fehlercode.

Bemerkungen

Die ZwSetQuotaInformationFile Routine wendet alle Kontingenteinträge im angegebenen Buffer Parameter auf das Volume an.

Die IoCheckQuotaBufferValidity-funktion kann überprüfen, ob der angegebene Kontingentpuffer, der als Buffer Parameter übergeben wurde, gültig ist.

Ein Aufruf von ZwSetQuotaInformationFile- 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 ZwSetQuotaInformationFile fehl, wenn STATUS_INVALID_DEVICE_REQUEST zurückgegeben werden.

Anmerkung

Wenn der Aufruf der ZwSetQuotaInformationFile Funktion im Benutzermodus auftritt, sollten Sie den Namen "NtSetQuotaInformationFile" anstelle von "ZwSetQuotaInformationFile" 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)