DIDiskQuotaUser 对象

允许客户端管理 NTFS 卷的全局磁盘配额设置。 此对象使 DIDiskQuotaUser 接口的基本功能可用于脚本编写和基于 Microsoft Visual Basic 的应用程序。

成员

DIDiskQuotaUser 对象具有以下类型的成员：

• 方法
• 属性

方法

DIDiskQuotaUser 对象具有这些方法。

方法	说明
无效	清除对象的缓存用户信息。

 

属性

DIDiskQuotaUser 对象具有这些属性。

属性	访问类型	说明
AccountContainerName	只读	获取用户帐户容器的名称。
AccountStatus	只读	获取用户帐户的状态。
DisplayName	只读	获取用户的显示名称。
ID	只读	获取唯一标识用户的 ID。
LogonName	只读	获取用户的登录帐户名称。
QuotaLimit	读取/写入	设置或获取用户的当前 配额限制。
QuotaLimitText	只读	以文本字符串的形式获取用户的当前 配额限制 。
QuotaThreshold	读取/写入	设置或获取用户的警告阈值（以字节为单位）。
QuotaThresholdText	只读	获取用户警告阈值作为文本字符串。
QuotaUsed	只读	获取用户的当前磁盘使用情况（以字节为单位）。
QuotaUsedText	只读	以文本字符串的形式获取用户的当前磁盘使用情况。

 

备注

由 DiskQuotaControl 对象管理的卷上的每个用户都有一个与之关联的 DIDiskQuotaUser 对象。 此对象允许客户端管理单个用户的设置。 可通过多种方式获取用户的 DIDiskQuotaUser 对象：

• 卷上具有配额的所有用户的 DIDiskQuotaUser 对象将作为集合公开，并且可以枚举。 下面介绍了如何枚举 DIDiskQuotaUser 对象。
• 添加新用户时， AddUser 方法将返回该用户的 DIDiskQuotaUser 对象。
• 如果你有用户的名称， FindUser 方法将返回用户的 DIDiskQuotaUser 对象。

枚举磁盘配额用户

卷上具有配额的所有用户的 DIDiskQuotaUser 对象将公开为集合。 DiskQuotaControl 对象导出标准枚举器方法，该方法允许枚举 DIDiskQuotaUser 对象的集合。 以下过程演示如何使用与 ECMA 262 语言规范) 兼容的 Microsoft JScript (执行枚举。 可以将类似的过程与 Visual Basic 或 Microsoft Visual Basic Scripting Edition (VBScript) 配合使用。

1. 创建新的 DiskQuotaControl 对象。
2. 使用 Initialize 初始化它。
3. 创建新的 JScript 枚举器 对象。
4. 使用 for 循环枚举 DIDiskQuotaUser 对象。 无需设置起始值。 枚举器对象的 moveNext 方法通知 item 方法返回下一个 DIDiskQuotaUser 对象。 到达列表末尾时， atEnd 方法返回 false 。
5. 根据需要，使用枚举器的 item 方法返回的 DIDiskQuotaUser 对象来检索或设置一个或多个关联用户的磁盘配额属性。

以下代码片段演示如何使用 JScript 枚举 DIDiskQuotaUser 对象。 传递给 EnumUsers 函数的 Volume_Label 参数是包含卷标签（如“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 或更高版本)

另请参阅

Shell 对象