Поделиться через


Объект DIDiskQuotaUser

Позволяет клиенту управлять параметрами глобальной квоты диска тома NTFS. Этот объект делает основные функциональные возможности интерфейса DIDiskQuotaUser доступными для сценариев и приложений на основе Microsoft Visual Basic.

Элементы

Объект DIDiskQuotaUser имеет следующие типы элементов:

Методы

Объект DIDiskQuotaUser содержит следующие методы.

Метод Описание
Invalidate Очищает кэшированные сведения о пользователе объекта.

 

Свойства

Объект DIDiskQuotaUser имеет следующие свойства.

Свойство Тип доступа Описание
AccountContainerName
Только для чтения
Возвращает имя контейнера учетной записи пользователя.
AccountStatus
Только для чтения
Возвращает состояние учетной записи пользователя.
DisplayName
Только для чтения
Возвращает отображаемое имя пользователя.
ID
Только для чтения
Возвращает идентификатор, который однозначно идентифицирует пользователя.
Имя входа
Только для чтения
Возвращает имя учетной записи для входа пользователя.
QuotaLimit
Чтение/запись
Задает или получает текущее ограничение квоты пользователя.
QuotaLimitText
Только для чтения
Возвращает текущее ограничение квоты пользователя в виде текстовой строки.
QuotaThreshold
Чтение/запись
Задает или получает пороговое значение предупреждения пользователя в байтах.
QuotaThresholdText
Только для чтения
Возвращает пороговое значение предупреждения пользователя в виде текстовой строки.
QuotaUsed
Только для чтения
Возвращает текущее использование диска пользователем (в байтах).
QuotaUsedText
Только для чтения
Возвращает текущее использование диска пользователем в виде текстовой строки.

 

Комментарии

Каждый пользователь тома, управляемый объектом DiskQuotaControl , имеет связанный с ним объект DIDiskQuotaUser . Этот объект позволяет клиенту управлять параметрами отдельного пользователя. Существует несколько способов получения объекта DIDiskQuotaUser пользователя.

  • Объекты DIDiskQuotaUser для всех пользователей с квотами на томе предоставляются в виде коллекции и могут быть перечислены. Ниже приведено описание перечисления объектов DIDiskQuotaUser .
  • При добавлении нового пользователя метод AddUser возвращает объект DIDiskQuotaUser пользователя.
  • Если у вас есть имя пользователя, метод FindUser возвращает объект DIDiskQuotaUser пользователя.

Перечисление пользователей дисковой квоты

Объекты DIDiskQuotaUser для всех пользователей с квотой на томе предоставляются в виде коллекции. Объект DiskQuotaControl экспортирует стандартный метод перечислителя, который позволяет перечислить коллекцию объектов DIDiskQuotaUser . В следующей процедуре показано, как выполнить перечисление с помощью Microsoft JScript (совместимо со спецификацией языка ECMA 262). Аналогичную процедуру можно использовать с Visual Basic или Microsoft Visual Basic Scripting Edition (VBScript).

  1. Создайте новый объект DiskQuotaControl .
  2. Инициализируйте его с помощью команды Initialize.
  3. Создайте новый объект перечислителя JScript.
  4. Используйте цикл for для перечисления объектов DIDiskQuotaUser . Не нужно задавать начальное значение. Метод moveNext объекта перечислителя уведомляет метод item о возвращении следующего объекта DIDiskQuotaUser . Метод atEnd возвращает значение false по достижении конца списка.
  5. При необходимости используйте объект DIDiskQuotaUser , возвращаемый методом элемента перечислителя, чтобы получить или задать одно или несколько свойств квоты диска связанного пользователя.

В следующем фрагменте кода показано, как перечислить объекты DIDiskQuotaUser с помощью JScript. Аргумент Volume_Label , передаваемый в функцию EnumUsers , является строковым значением, содержащим метку тома, например "C:\\".

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
     ...
    }
}

Требования

Требование Значение
Минимальная версия клиента
Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
Windows 2000 Server [только классические приложения]
DLL
Shell32.dll (версия 5.0 или более поздняя)

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

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