FILE_QUOTA_INFORMATION-Struktur (ntifs.h)

Artikel
03/05/2024

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.