structure FILE_QUOTA_INFORMATION (ntifs.h)

  • Article

La structure FILE_QUOTA_INFORMATION est utilisée pour interroger ou définir les informations de quota par utilisateur pour chacun des fichiers d’un répertoire.

Syntaxe

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;

Membres

NextEntryOffset

Décalage, en octets, de l’entrée de quota suivante dans la liste. S’il n’y a plus d’entrées après celle actuelle, ce membre est égal à zéro.

SidLength

Longueur, en octets, du membre Sid .

ChangeTime

Heure à laquelle cette entrée de quota a été modifiée pour la dernière fois.

QuotaUsed

Quantité d’espace disque sur ce volume actuellement utilisé par l’utilisateur.

QuotaThreshold

Montage maximal de l’espace disque sur ce volume qui peut être utilisé par l’utilisateur sans déclencher d’événement. Pour plus d’informations, consultez FILE_FS_CONTROL_INFORMATION.

QuotaLimit

Quantité maximale d’espace disque sur ce volume qui peut être utilisée par l’utilisateur.

Sid

Identificateur de sécurité (SID) de l’utilisateur.

Remarques

Aucun droit d’accès spécifique n’est requis pour interroger ces informations. Pour effectuer cette requête, créez un IRP avec le code de fonction principal IRP_MJ_QUERY_QUOTA.

FILE_WRITE_DATA’accès au volume est requis pour définir ces informations. Pour effectuer cette opération, créez un IRP avec le code de fonction principal IRP_MJ_SET_QUOTA.

Pour case activée la validité d’une mémoire tampon contenant FILE_QUOTA_INFORMATION structure, appelez IoCheckQuotaBufferValidity.

Sur les plateformes 32 bits, cette structure doit être alignée sur une limite LONG (4 octets). Si une mémoire tampon contient au moins deux de ces structures, la valeur NextEntryOffset dans chaque entrée, à l’exception de la dernière, se situe sur une limite de 4 octets.

Sur les plateformes 64 bits, cette structure doit être alignée sur une limite LONGLONG (8 octets). Si une mémoire tampon contient au moins deux de ces structures, la valeur NextEntryOffset de chaque entrée, à l’exception de la dernière, se situe sur une limite de 8 octets.

Configuration requise

Condition requise Valeur
En-tête ntifs.h (include Ntifs.h, Fltkernel.h)

Voir aussi

FILE_FS_CONTROL_INFORMATION

IRP_MJ_QUERY_QUOTA

IRP_MJ_SET_QUOTA

IoCheckQuotaBufferValidity