DIDiskQuotaUser-Objekt

Ermöglicht es einem Client, die globalen Datenträgerkontingenteinstellungen eines NTFS-Volumes zu verwalten. Dieses Objekt stellt die wesentlichen Funktionen der DIDiskQuotaUser-Schnittstelle für Skripterstellung und Microsoft Visual Basic-basierte Anwendungen zur Verfügung.

Member

Das DIDiskQuotaUser-Objekt verfügt über die folgenden Membertypen:

• Methoden
• Eigenschaften

Methoden

Das DIDiskQuotaUser-Objekt verfügt über diese Methoden.

Eigenschaften

Das DIDiskQuotaUser-Objekt verfügt über diese Eigenschaften.

Bemerkungen

Jedem Benutzer auf dem Volume, das vom DiskQuotaControl-Objekt verwaltet wird, ist ein DIDiskQuotaUser-Objekt zugeordnet. Mit diesem Objekt kann ein Client die Einstellungen eines einzelnen Benutzers verwalten. Es gibt mehrere Möglichkeiten, das DIDiskQuotaUser-Objekt eines Benutzers abzurufen:

• Die DIDiskQuotaUser-Objekte für alle Benutzer mit Kontingenten auf dem Volume werden als Auflistung verfügbar gemacht und können aufgelistet werden. Unten finden Sie eine Erläuterung zum Auflisten von DIDiskQuotaUser-Objekten .
• Wenn Sie einen neuen Benutzer hinzufügen, gibt die AddUser-Methode das DIDiskQuotaUser-Objekt des Benutzers zurück.
• Wenn Sie über den Namen des Benutzers verfügen, gibt die FindUser-Methode das DIDiskQuotaUser-Objekt des Benutzers zurück.

Auflisten von Datenträgerkontingentbenutzern

Die DIDiskQuotaUser-Objekte für alle Benutzer mit einem Kontingent auf dem Volume werden als Auflistung verfügbar gemacht. Das DiskQuotaControl-Objekt exportiert eine Standard-Enumeratormethode, mit der Sie die Auflistung von DIDiskQuotaUser-Objekten auflisten können. Das folgende Verfahren veranschaulicht, wie die Enumeration mit Microsoft JScript (kompatibel mit der ECMA 262-Sprachspezifikation) ausgeführt wird. Sie können ein ähnliches Verfahren mit Visual Basic oder Microsoft Visual Basic Scripting Edition (VBScript) verwenden.

1. Erstellen Sie ein neues DiskQuotaControl-Objekt .
2. Initialisieren Sie sie mit Initialize.
3. Erstellen Sie ein neues JScript-Enumerator-Objekt .
4. Verwenden Sie eine for-Schleife , um die DIDiskQuotaUser-Objekte aufzulisten. Es ist nicht erforderlich, einen Startwert festzulegen. Die moveNext-Methode des enumerator-Objekts benachrichtigt die item-Methode , um das nächste DIDiskQuotaUser-Objekt zurückzugeben. Die atEnd-Methode gibt false zurück, wenn Sie das Ende der Liste erreichen.
5. Verwenden Sie bei Bedarf das DIDiskQuotaUser-Objekt , das von der item-Methode des Enumerators zurückgegeben wird, um eine oder mehrere der Datenträgerkontingenteigenschaften des zugeordneten Benutzers abzurufen oder festzulegen.

Das folgende Codefragment veranschaulicht, wie SIE DIDiskQuotaUser-Objekte mit JScript auflisten. Das Volume_Label-Argument , das an die EnumUsers-Funktion übergeben wird, ist ein Zeichenfolgenwert, der eine Volumebezeichnung wie "C:\\" enthält.

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
     ...
    }
}

Anforderungen

Siehe auch

Shell-Objekt