FILE_QUOTA_INFORMATION-Struktur (ntifs.h)
Die FILE_QUOTA_INFORMATION-Struktur wird verwendet, um benutzerspezifische Kontingentinformationen für jede Datei in einem Verzeichnis abzufragen oder festzulegen.
Syntax
typedef struct _FILE_QUOTA_INFORMATION {
ULONG NextEntryOffset;
ULONG SidLength;
LARGE_INTEGER ChangeTime;
LARGE_INTEGER QuotaUsed;
LARGE_INTEGER QuotaThreshold;
LARGE_INTEGER QuotaLimit;
SID Sid;
} FILE_QUOTA_INFORMATION, *PFILE_QUOTA_INFORMATION;
Member
NextEntryOffset
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).
SidLength
Länge des Sid-Elements in Byte.
ChangeTime
Zeitpunkt der letzten Änderung dieses Kontingenteintrags.
QuotaUsed
Menge des Speicherplatzes auf diesem Volume, der derzeit vom Benutzer verwendet wird.
QuotaThreshold
Maximale Bereitstellung des Speicherplatzes auf diesem Volume, der vom Benutzer verwendet werden kann, ohne ein Ereignis auszulösen. Weitere Informationen finden Sie unter FILE_FS_CONTROL_INFORMATION.
QuotaLimit
Maximaler Speicherplatz auf diesem Volume, der vom Benutzer verwendet werden kann.
Sid
Sicherheits-ID (SID) des Benutzers.
Hinweise
Zum Abfragen dieser Informationen sind keine spezifischen Zugriffsrechte erforderlich. Um diese Abfrage auszuführen, erstellen Sie ein IRP mit hauptfunktionscode IRP_MJ_QUERY_QUOTA.
FILE_WRITE_DATA Zugriff auf das Volume ist erforderlich, um diese Informationen festzulegen. Um diesen Vorgang auszuführen, erstellen Sie ein IRP mit hauptfunktionscode IRP_MJ_SET_QUOTA.
Rufen Sie IoCheckQuotaBufferValidity auf, um die Gültigkeit eines Puffers zu überprüfen, der FILE_QUOTA_INFORMATION Struktur enthält.
Auf 32-Bit-Plattformen muss diese Struktur an einer LONG-Grenze (4 Byte) ausgerichtet werden. Wenn ein Puffer zwei oder mehr dieser Strukturen enthält, fällt der NextEntryOffset-Wert in jedem Eintrag mit Ausnahme des letzten auf eine 4-Byte-Grenze.
Auf 64-Bit-Plattformen muss diese Struktur an einer LONGLONG-Grenze (8 Byte) ausgerichtet werden. Wenn ein Puffer zwei oder mehr dieser Strukturen enthält, fällt der NextEntryOffset-Wert in jedem Eintrag mit Ausnahme des letzten auf eine 8-Byte-Grenze.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ntifs.h (include Ntifs.h, Fltkernel.h) |