DiskQuotaControl-Objekt
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 |
|
Siehe auch