Objet DiskQuotaControl

  • Article

Permet à un administrateur de gérer les propriétés de quota de disque d’un volume. Le système de fichiers NTFS permet à un administrateur de gérer l’utilisation du disque sur un volume partagé en allouant une quantité spécifiée d’espace disque, ou limite de quota, à chaque utilisateur. Vous pouvez utiliser cet objet pour définir la limite de quota par défaut qui sera automatiquement affectée à tous les nouveaux utilisateurs.

Membres

L’objet DiskQuotaControl a les types de membres suivants :

Événements

L’objet DiskQuotaControl contient ces événements.

Événement Description
OnUserNameChanged Se produit lorsque les informations de nom d’un objet DIDiskQuotaUser ont été résolues.

 

Méthodes

L’objet DiskQuotaControl a ces méthodes.

Méthode Description
Adduser Affecte un quota de disque non défini par défaut à un nouvel utilisateur.
DeleteUser Supprime un utilisateur du volume.
FindUser Recherche l’entrée d’un utilisateur, par son nom, dans le fichier de quota du volume.
GiveUserNameResolutionPriority Place l’objet utilisateur spécifié à côté de la ligne pour la résolution de noms.
Initialiser Ouvre un volume spécifié et initialise son objet de contrôle de quota.
InvalidateSidNameCache Invalide le cache de nom d’utilisateur de l’ID de sécurité.
ShutdownNameResolution Arrête le thread de résolution de noms d’utilisateur.
TranslateLogonNameToSID Convertit un nom d’ouverture de session en ID de sécurité utilisateur correspondant au format chaîne.

 

Propriétés

L’objet DiskQuotaControl a ces propriétés.

Propriété Type d’accès Description
DefaultQuotaLimit
 Lecture/écriture
 Définit ou obtient la limite de quota par défaut.
DefaultQuotaLimitText
 Lecture seule
 Obtient la limite de quota par défaut sous forme de chaîne de texte.
DefaultQuotaThreshold
 Lecture/écriture
 Définit ou obtient le seuil de quota par défaut.
DefaultQuotaThresholdText
 Lecture seule
 Obtient le seuil de quota par défaut sous forme de chaîne de texte.
LogQuotaLimit
 Lecture/écriture
 Définit ou obtient une valeur booléenne qui indique si une entrée de journal des événements système est effectuée lorsqu’un utilisateur dépasse sa limite de quota attribuée.
LogQuotaThreshold
 Lecture/écriture
 Définit ou obtient une valeur booléenne qui indique si une entrée de journal des événements système est effectuée lorsqu’un utilisateur dépasse son seuil de quota attribué.
QuotaFileIncomplete
 Lecture seule
 Obtient une valeur booléenne qui indique si le fichier de quota pour le volume est terminé.
QuotaFileRebuilding
 Lecture seule
 Obtient une valeur booléenne qui indique si le fichier de quota pour le volume est en cours de reconstruction.
QuotaState
 Lecture/écriture
 Définit ou obtient l’état des quotas de disque du volume.
UserNameResolution
 Lecture/écriture
 Définit ou obtient une valeur qui contrôle la façon dont les SID utilisateur sont résolus en noms d’utilisateur.

 

Notes

Un administrateur peut utiliser l’objet DiskQuotaControl pour effectuer un certain nombre de tâches, notamment les suivantes :

  • Activation et désactivation du système de quota de disque du volume.
  • Obtention de la status du système de quota sur le volume.
  • Refus de l’espace disque aux utilisateurs qui dépassent leur limite de quota.
  • Spécification du seuil d’avertissement par défaut et des valeurs limites de quota qui seront affectées aux nouveaux utilisateurs.
  • Ajout et suppression d’utilisateurs.

L’objet DiskQuotaControl vous permet de définir des valeurs globales par défaut pour le volume pour des propriétés telles que des limites de quota. Toutefois, chaque utilisateur est représenté par un objet DIDiskQuotaUser qui peut être utilisé pour spécifier des paramètres de quota individuels.

Il existe plusieurs façons d’obtenir l’objet DIDiskQuotaUser d’un utilisateur :

  • Les objets DIDiskQuotaUser pour tous les utilisateurs disposant de quotas sur le volume sont exposés en tant que collection et peuvent être énumérés. Pour plus d’informations sur l’énumération des objets DIDiskQuotaUser , consultez Énumération des utilisateurs de quota de disque dans la section Remarques de DIDiskQuotaUser.
  • Lorsque vous ajoutez un nouvel utilisateur, la méthode AddUser renvoie l’objet DIDiskQuotaUser de l’utilisateur.
  • Si vous avez le nom de l’utilisateur, la méthode FindUser renvoie l’objet DIDiskQuotaUser de l’utilisateur.

Cet objet rend les fonctionnalités essentielles de l’interface IDiskQuotaControl disponibles pour les scripts et les applications basées sur Microsoft Visual Basic.

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows 2000 Server [applications de bureau uniquement]
DLL
Shell32.dll (version 5.0 ou ultérieure)

Voir aussi

Shell, objet