Объект DiskQuotaControl
Позволяет администратору управлять свойствами квоты диска тома. Файловая система NTFS позволяет администратору управлять использованием диска на общем томе, выделяя для каждого пользователя определенный объем дискового пространства или квоту. Этот объект можно использовать для установки квоты по умолчанию, которая будет автоматически назначена всем новым пользователям.
Элементы
Объект DiskQuotaControl имеет следующие типы элементов:
События
Объект DiskQuotaControl содержит эти события.
| Событие | Описание |
|---|---|
| OnUserNameChanged | Происходит при разрешении сведений об имени для объекта DIDiskQuotaUser . |
Методы
Объект DiskQuotaControl содержит следующие методы.
| Метод | Описание |
|---|---|
| AddUser | Назначает новому пользователю квоту дисков, не являющихся стандартными. |
| DeleteUser | Удаляет пользователя из тома. |
| FindUser | Находит запись пользователя по имени в файле квоты тома. |
| GiveUserNameResolutionPriority | Помещает указанный объект пользователя в строку для разрешения имен. |
| Initialize | Открывает указанный том и инициализирует его объект управления квотами. |
| InvalidateSidNameCache | Делает недействительным кэш имен пользователей идентификатора безопасности. |
| ShutdownNameResolution | Завершает работу потока разрешения имен пользователей. |
| TranslateLogonNameToSID | Преобразует имя входа в соответствующий идентификатор безопасности пользователя в строковом формате. |
Свойства
Объект DiskQuotaControl имеет следующие свойства.
| Свойство | Тип доступа | Описание |
|---|---|---|
|
DefaultQuotaLimit |
Чтение/запись |
Задает или получает ограничение квоты по умолчанию. |
|
DefaultQuotaLimitText |
Только для чтения |
Возвращает ограничение квоты по умолчанию в виде текстовой строки. |
|
DefaultQuotaThreshold |
Чтение/запись |
Задает или получает порог квоты по умолчанию. |
|
DefaultQuotaThresholdText |
Только для чтения |
Возвращает порог квоты по умолчанию в виде текстовой строки. |
|
LogQuotaLimit |
Чтение/запись |
Задает или получает логическое значение, указывающее, будет ли запись журнала системных событий выполняться при превышении пользователем установленного предела квоты. |
|
LogQuotaThreshold |
Чтение/запись |
Задает или получает логическое значение, указывающее, будет ли запись журнала системных событий выполняться при превышении пользователем установленного порогового значения квоты. |
|
QuotaFileIncomplete |
Только для чтения |
Возвращает логическое значение, указывающее, завершен ли файл квоты для тома. |
|
QuotaFileRebuilding |
Только для чтения |
Возвращает логическое значение, указывающее, перестраивается ли файл квоты для тома. |
|
QuotaState |
Чтение/запись |
Задает или получает состояние дисковых квот тома. |
|
UserNameResolution |
Чтение/запись |
Задает или получает значение, определяющее способ разрешения идентификатора безопасности пользователя в имена пользователей. |
Комментарии
Администратор может использовать объект DiskQuotaControl для выполнения ряда задач, включая следующие:
- Включение и отключение системы дисковой квоты тома.
- Получение состояния системы квот на томе.
- Запрет места на диске для пользователей, превышающих квоту.
- Указание порогового значения предупреждения по умолчанию и предельных значений квоты, которые будут назначены новым пользователям.
- Добавление и удаление пользователей.
Объект DiskQuotaControl позволяет задать глобальные значения по умолчанию для тома для таких свойств, как ограничения квоты. Однако каждый пользователь представлен объектом DIDiskQuotaUser , который можно использовать для указания отдельных параметров квоты.
Существует несколько способов получения объекта DIDiskQuotaUser пользователя.
- Объекты DIDiskQuotaUser для всех пользователей с квотами на томе предоставляются в виде коллекции и могут быть перечислены. Описание перечисления объектов DIDiskQuotaUser см. в разделе Перечисление пользователей дисковой квоты в разделе Примечания diDiskQuotaUser.
- При добавлении нового пользователя метод AddUser возвращает объект DIDiskQuotaUser пользователя.
- Если у вас есть имя пользователя, метод FindUser возвращает объект DIDiskQuotaUser пользователя.
Этот объект делает основные функциональные возможности интерфейса IDiskQuotaControl доступными для сценариев и приложений на основе Microsoft Visual Basic.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| DLL |
|
См. также раздел