DiskQuotaControl-Objekt

  • Artikel

Ermöglicht es einem Administrator, die Datenträgerkontingenteigenschaften eines Volumes zu verwalten. Das NTFS-Dateisystem ermöglicht es einem Administrator, die Datenträgernutzung auf einem freigegebenen Volume zu verwalten, indem er jedem Benutzer eine bestimmte Menge an Speicherplatz oder ein Kontingentlimit zuzuweisen. Sie können dieses Objekt verwenden, um die Standardkontingentgrenze festzulegen, die automatisch allen neuen Benutzern zugewiesen wird.

Member

Das DiskQuotaControl-Objekt verfügt über folgende Membertypen:

Ereignisse

Das DiskQuotaControl-Objekt weist diese Ereignisse auf.

Ereignis BESCHREIBUNG
OnUserNameChanged Tritt auf, wenn die Namensinformationen für ein DIDiskQuotaUser-Objekt aufgelöst wurden.

 

Methoden

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

Methode BESCHREIBUNG
Adduser Weist einem neuen Benutzer ein nicht standardmäßiges Datenträgerkontingent zu.
DeleteUser Löscht einen Benutzer aus dem Volume.
FindUser Sucht den Eintrag eines Benutzers anhand des Namens in der Kontingentdatei des Volumes.
GiveUserNameResolutionPriority Platziert das angegebene Benutzerobjekt in der nächsten Zeile für die Namensauflösung.
Initialisieren Öffnet ein angegebenes Volume und initialisiert dessen Kontingentsteuerungsobjekt.
InvalidateSidNameCache Ungültigt den Benutzernamencache der Sicherheits-ID.
ShutdownNameResolution Beendet den Thread zur Auflösung des Benutzernamens.
TranslateLogonNameToSID Übersetzt einen Anmeldenamen in die entsprechende Benutzersicherheits-ID im Zeichenfolgenformat.

 

Eigenschaften

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

Eigenschaft Zugriffstyp BESCHREIBUNG
DefaultQuotaLimit
 Lesen/Schreiben
 Legt den Standardkontingentgrenzwert fest oder ruft sie ab.
DefaultQuotaLimitText
 Schreibgeschützt
 Ruft das Standardkontingentlimit als Textzeichenfolge ab.
DefaultQuotaThreshold
 Lesen/Schreiben
 Legt den Standardkontingentschwellenwert fest oder ruft sie ab.
DefaultQuotaThresholdText
 Schreibgeschützt
 Ruft den Standardkontingentschwellenwert als Textzeichenfolge ab.
LogQuotaLimit
 Lesen/Schreiben
 Legt fest oder ruft einen booleschen Wert ab, der angibt, ob ein Systemereignisprotokolleintrag vorgenommen wird, wenn ein Benutzer sein zugewiesenes Kontingentlimit überschreitet.
LogQuotaThreshold
 Lesen/Schreiben
 Legt einen booleschen Wert fest, der angibt, ob ein Systemereignisprotokolleintrag vorgenommen wird, wenn ein Benutzer seinen zugewiesenen Kontingentschwellenwert überschreitet, oder ruft diesen ab.
QuotaFileIncomplete
 Schreibgeschützt
 Ruft einen booleschen Wert ab, der angibt, ob die Kontingentdatei für das Volume vollständig ist.
QuotaFileRebuilding
 Schreibgeschützt
 Ruft einen booleschen Wert ab, der angibt, ob die Kontingentdatei für das Volume gerade neu erstellt wird.
QuotaState
 Lesen/Schreiben
 Legt den Zustand der Datenträgerkontingente des Volumes fest oder ruft diese ab.
UserNameResolution
 Lesen/Schreiben
 Legt einen Wert fest, der steuert, wie die Benutzer-SID in Benutzernamen aufgelöst wird, oder ruft diesen ab.

 

Bemerkungen

Ein Administrator kann das DiskQuotaControl-Objekt verwenden, um eine Reihe von Aufgaben auszuführen, einschließlich der folgenden:

  • Aktivieren und Deaktivieren des Datenträgerkontingentsystems des Volumes.
  • Abrufen der status des Kontingentsystems auf dem Volume.
  • Verweigern des Speicherplatzes für Benutzer, die ihre Kontingentgrenze überschreiten.
  • Angeben des Standardmäßigen Warnungsschwellenwerts und der Kontingentgrenzwerte, die neuen Benutzern zugewiesen werden.
  • Hinzufügen und Entfernen von Benutzern.

Mit dem DiskQuotaControl-Objekt können Sie globale Standardwerte für das Volume für Eigenschaften wie Kontingentlimits festlegen. Jeder Benutzer wird jedoch durch ein DIDiskQuotaUser-Objekt dargestellt, das zum Angeben einzelner Kontingenteinstellungen verwendet werden kann.

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 Sammlung verfügbar gemacht und können aufgezählt werden. Eine Erläuterung zum Auflisten von DIDiskQuotaUser-Objekten finden Sie unter Auflisten von Datenträgerkontingentbenutzern im Abschnitt Hinweise von DIDiskQuotaUser.
  • 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.

Dieses Objekt stellt die wesentlichen Funktionen der IDiskQuotaControl-Schnittstelle für Skripts und Microsoft Visual Basic-basierte Anwendungen zur Verfügung.

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