OBJET DIDiskQuotaUser

Article
06/13/2023

Permet à un client de gérer les paramètres de quota de disque global d’un volume NTFS. Cet objet rend les fonctionnalités essentielles de l’interface DIDiskQuotaUser disponibles pour les scripts et les applications basées sur Microsoft Visual Basic.

Membres

L’objet DIDiskQuotaUser a les types de membres suivants :

Méthodes
Propriétés

Méthodes

L’objet DIDiskQuotaUser possède ces méthodes.

Méthode	Description
Invalidate	Efface les informations utilisateur mises en cache de l’objet.

Propriétés

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

Propriété	Type d’accès	Description
AccountContainerName	Lecture seule	Obtient le nom du conteneur de compte de l’utilisateur.
AccountStatus	Lecture seule	Obtient la status du compte de l’utilisateur.
DisplayName	Lecture seule	Obtient le nom d’affichage de l’utilisateur.
id	Lecture seule	Obtient un ID qui identifie de manière unique l’utilisateur.
Nom d’ouverture de session	Lecture seule	Obtient le nom du compte d’ouverture de session de l’utilisateur.
QuotaLimit	Lecture/écriture	Définit ou obtient la limite de quota actuelle de l’utilisateur.
QuotaLimitText	Lecture seule	Obtient la limite de quota actuelle de l’utilisateur sous forme de chaîne de texte.
QuotaThreshold	Lecture/écriture	Définit ou obtient le seuil d’avertissement de l’utilisateur, en octets.
QuotaThresholdText	Lecture seule	Obtient le seuil d’avertissement de l’utilisateur sous forme de chaîne de texte.
QuotaUsed	Lecture seule	Obtient l’utilisation actuelle du disque de l’utilisateur, en octets.
QuotaUsedText	Lecture seule	Obtient l’utilisation actuelle du disque de l’utilisateur sous forme de chaîne de texte.

Notes

Chaque utilisateur du volume géré par l’objet DiskQuotaControl est associé à un objet DIDiskQuotaUser . Cet objet permet à un client de gérer les paramètres d’un utilisateur individuel. 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. Vous trouverez ci-dessous une description de la façon d’énumérer les objets DIDiskQuotaUser .
Lorsque vous ajoutez un nouvel utilisateur, la méthode AddUser retourne 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.

Énumération des utilisateurs de quota de disque

Les objets DIDiskQuotaUser pour tous les utilisateurs disposant d’un quota sur le volume sont exposés en tant que collection. L’objet DiskQuotaControl exporte une méthode d’énumération standard qui vous permet d’énumérer la collection d’objets DIDiskQuotaUser . La procédure suivante montre comment effectuer l’énumération avec Microsoft JScript (compatible avec la spécification du langage ECMA 262). Vous pouvez utiliser une procédure similaire avec Visual Basic ou Microsoft Visual Basic Scripting Edition (VBScript).

Créez un objet DiskQuotaControl .
Initialisez-le avec Initialize.
Créez un objet JScript Enumerator .
Utilisez une boucle for pour énumérer les objets DIDiskQuotaUser . Il n’est pas nécessaire de définir une valeur de départ. La méthode moveNext de l’objet énumérateur avertit la méthode item de renvoyer l’objet DIDiskQuotaUser suivant. La méthode atEnd retourne false lorsque vous atteignez la fin de la liste.
Si nécessaire, utilisez l’objet DIDiskQuotaUser retourné par la méthode item de l’énumérateur pour récupérer ou définir une ou plusieurs propriétés de quota de disque de l’utilisateur associé.

Le fragment de code suivant montre comment énumérer des objets DIDiskQuotaUser avec JScript. L’argument Volume_Label passé à la fonction EnumUsers est une valeur de chaîne contenant une étiquette de volume telle que « C:\\ ».

function EnumUsers(Volume_Label)
{
    var Volume;
    var QuotaUsers;
    var QuotaUser;

    Volume = new ActiveXObject("Microsoft.DiskQuota.1");
    Volume.Initialize(Volume_Label, 1);

    QuotaUsers = new Enumerator(Volume);
    for (;!Users.atEnd(); Users.moveNext())
    {
       QuotaUser = QuotaUsers.item();

     //Use the QuotaUser object to retrieve or set one or more
     //of the user's disk quota properties
     ...
    }
}

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

Objet Shell