Objet DIDiskQuotaUser

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 possède les types de membres suivants :

Méthodes

L’objet DIDiskQuotaUser a 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 l’état du compte de l’utilisateur.
NomComplet
Lecture seule
Obtient le nom complet de l’utilisateur.
id
Lecture seule
Obtient un ID qui identifie de façon unique l’utilisateur.
LogonName
Lecture seule
Obtient le nom du compte d’ouverture de session de l’utilisateur.
QuotaLimit
Lecture/écriture
Définit ou obtient la limite de quotaactuelle de l’utilisateur.
QuotaLimitText
Lecture seule
Obtient la limite de quota actuelle de l’utilisateur sous la forme d’une 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 la forme d’une chaîne de texte.
QuotaUsed
Lecture seule
Obtient l’utilisation actuelle du disque de l’utilisateur, en octets.
QuotaUsedText
Lecture seule
Obtient l’utilisation du disque actuel de l’utilisateur sous la forme d’une chaîne de texte.

Notes

Chaque utilisateur sur le volume qui est 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 avec quotas sur le volume sont exposés en tant que collection et peuvent être énumérés. Vous trouverez ci-dessous une discussion sur l’énumération des 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 retourne l’objet DIDiskQuotaUser de l’utilisateur.

Énumération des utilisateurs du quota de disque

Les objets DIDiskQuotaUser pour tous les utilisateurs avec un quota sur le volume sont exposés en tant que collection. L’objet DiskQuotaControl exporte une méthode d’énumérateur 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).

  1. Créez un nouvel objet DiskQuotaControl .
  2. Initialisez-le avec Initialize.
  3. créez un nouvel objet énumérateur JScript.
  4. 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 Enumerator indique à la méthode Item de retourner l’objet DIDiskQuotaUser suivant. La méthode atEnd retourne la valeur false lorsque vous atteignez la fin de la liste.
  5. 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 des propriétés de quota de disque de l’utilisateur associé.

Le fragment de code suivant montre comment énumérer les objets DIDiskQuotaUser avec JScript. L’argument de _ nom de volume qui est passé à la fonction EnumUsers est une valeur de chaîne contenant un nom de volume tel 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