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.

Methode	BESCHREIBUNG
Invalidate	Löscht die zwischengespeicherten Benutzerinformationen des Objekts.

 

Eigenschaften

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

Eigenschaft	Zugriffstyp	BESCHREIBUNG
AccountContainerName	Schreibgeschützt	Ruft den Namen des Kontocontainers des Benutzers ab.
AccountStatus	Schreibgeschützt	Ruft die status des Benutzerkontos ab.
DisplayName	Schreibgeschützt	Ruft den Anzeigenamen des Benutzers ab.
id	Schreibgeschützt	Ruft eine ID ab, die den Benutzer eindeutig identifiziert.
LogonName	Schreibgeschützt	Ruft den Anmeldekontonamen des Benutzers ab.
QuotaLimit	Lesen/Schreiben	Legt das aktuelle Kontingentlimit des Benutzers fest oder ruft es ab.
QuotaLimitText	Schreibgeschützt	Ruft das aktuelle Kontingentlimit des Benutzers als Textzeichenfolge ab.
QuotaThreshold	Lesen/Schreiben	Legt den Warnungsschwellenwert des Benutzers in Bytes fest oder ruft diese ab.
QuotaThresholdText	Schreibgeschützt	Ruft den Warnungsschwellenwert des Benutzers als Textzeichenfolge ab.
QuotaUsed	Schreibgeschützt	Ruft die aktuelle Datenträgernutzung des Benutzers in Bytes ab.
QuotaUsedText	Schreibgeschützt	Ruft die aktuelle Datenträgernutzung des Benutzers als Textzeichenfolge ab.

 

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
DLL	Shell32.dll (Version 5.0 oder höher)

Siehe auch

Shell-Objekt