Объект 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 или более поздняя)

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

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