Объект 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
Shell32.dll (версия 5.0 или более поздняя)

См. также раздел

Объект оболочки