Объект 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).
- Создайте новый объект DiskQuotaControl .
- Инициализируйте его с помощью команды Initialize.
- Создайте новый объект перечислителя JScript.
- Используйте цикл for для перечисления объектов DIDiskQuotaUser . Не нужно задавать начальное значение. Метод moveNext объекта перечислителя уведомляет метод item о возвращении следующего объекта DIDiskQuotaUser . Метод atEnd возвращает значение false по достижении конца списка.
- При необходимости используйте объект 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 |
|
См. также раздел