Objet DiskQuotaControl
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 |
|
Voir aussi