ZwSetQuotaInformationFile-Funktion (ntifs.h)
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-status-Blocks des Aufrufers.
[in] Buffer
Ein Puffer, der die neuen Kontingenteinträge enthält, die auf das Volume angewendet werden sollen. Die Kontingentinformationen müssen als eine oder mehrere FILE_QUOTA_INFORMATION-Strukturen formatiert sein. 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 weiteren Einträge vorhanden sind, ist dieser Member 0 (null).
[in] Length
Die Länge des Puffers in Bytes.
Rückgabewert
Die ZwSetQuotaInformationFile-Routine gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INSUFFICIENT_RESOURCES | Es gab nicht genügend Ressourcen, 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 | Das Volume ist schreibgeschützter Datenträger. Dies ist ein Fehlercode. |
Hinweise
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 wird, 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 keine Kontingentinformationen (z. B. FAT- und CDFS-Dateisysteme) unterstützt, gibt ZwSetQuotaInformationFile STATUS_INVALID_DEVICE_REQUEST nicht zurück.
Hinweis
Wenn der Aufruf der ZwSetQuotaInformationFile-Funktion im Benutzermodus erfolgt, 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 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 systemeigenen 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 | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |