DiskQuotaControl 对象

允许管理员管理卷的磁盘配额属性。 NTFS 文件系统允许管理员通过向每个用户分配指定的磁盘空间量(或 配额限制)来管理共享卷上的磁盘使用情况。 可以使用此对象设置自动分配给所有新用户的默认配额限制。

成员

DiskQuotaControl 对象具有以下类型的成员:

事件

DiskQuotaControl 对象具有这些事件。

事件 说明
OnUserNameChanged 在解析 DIDiskQuotaUser 对象的名称信息时发生。

 

方法

DiskQuotaControl 对象具有这些方法。

方法 说明
AddUser 将非默认磁盘配额分配给新用户。
DeleteUser 从卷中删除用户。
FindUser 在卷的配额文件中按名称查找用户的条目。
GiveUserNameResolutionPriority 将指定的用户对象放在下一行,以便进行名称解析。
初始化 打开指定的卷并初始化其配额控制对象。
InvalidateSidNameCache 使安全 ID 用户名缓存失效。
ShutdownNameResolution 关闭用户名解析线程。
TranslateLogonNameToSID 将登录名转换为字符串格式的相应用户安全 ID。

 

属性

DiskQuotaControl 对象具有这些属性。

属性 访问类型 说明
DefaultQuotaLimit
读取/写入
设置或获取默认配额限制。
DefaultQuotaLimitText
只读
获取默认配额限制作为文本字符串。
DefaultQuotaThreshold
读取/写入
设置或获取默认配额阈值。
DefaultQuotaThresholdText
只读
获取默认配额阈值作为文本字符串。
LogQuotaLimit
读取/写入
设置或获取一个布尔值,该值指示当用户超出其分配的配额限制时是否将创建系统事件日志条目。
LogQuotaThreshold
读取/写入
设置或获取一个布尔值,该值指示当用户超出其分配的配额阈值时是否将创建系统事件日志条目。
QuotaFileIncomplete
只读
获取一个布尔值,该值指示卷的配额文件是否完成。
QuotaFileRebuilding
只读
获取一个布尔值,该值指示当前是否正在重新生成卷的配额文件。
QuotaState
读取/写入
设置或获取卷磁盘配额的状态。
UserNameResolution
读取/写入
设置或获取一个值,该值控制如何将用户 SID 解析为用户名。

 

备注

管理员可以使用 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 或更高版本)

另请参阅

Shell 对象