通过

IDiskQuotaControl：：CreateEnumUsers 方法 (dskquota.h)

  • 项目

创建枚举器对象，用于枚举卷上的配额用户。 新创建的对象实现 IEnumDiskQuotaUsers 接口。

语法

HRESULT CreateEnumUsers(
  [in]  PSID                  *rgpUserSids,
  [in]  DWORD                 cpSids,
  [in]  DWORD                 fNameResolution,
  [out] PENUM_DISKQUOTA_USERS *ppEnum
);

参数

[in] rgpUserSids

安全标识符数组 (SID) 表示要包含在枚举中的用户对象的指针。 如果此值为 NULL，则枚举所有用户条目。

[in] cpSids

rgpUserSids 数组中的项数。 如果 rgpUserSids 为 NULL，则忽略。

[in] fNameResolution

指示如何获取用户帐户信息。 卷的配额信息按 SID 标识用户。 用户帐户信息 (（如域名、帐户名和全名) ）必须从网络域控制器或本地计算机（如果它不在网络上）获取。 此参数的取值可为下列值之一：

值 含义
DISKQUOTA_USERNAME_RESOLVE_ASYNC
2
 异步解析用户帐户信息。 IEnumDiskQuotaUsers：：Next 方法将立即返回。 调用方必须实现 IDiskQuotaEvents 接口，以在信息可用时接收通知。 如果在上一个请求期间缓存了信息，则一旦为对象提供服务，就会立即发出通知。 否则， 方法从网络域控制器获取信息，然后通知 IDiskQuotaEvents。
DISKQUOTA_USERNAME_RESOLVE_NONE
0
 不解析用户帐户信息。
DISKQUOTA_USERNAME_RESOLVE_SYNC
1
 同步解析用户帐户信息。 解析信息时 ，IEnumDiskQuotaUsers：：Next 方法返回 。 如果磁盘配额 SID 缓存中存在该信息，则会立即返回该信息。 否则， 方法必须找到信息。 这可能需要数秒钟的时间。

[out] ppEnum

指向 IEnumDiskQuotaUsers 枚举器的指针的指针。

返回值

此方法返回以下值之一。

返回代码 说明
S_OK
 成功。
ERROR_ACCESS_DENIED
 调用方的访问权限不足。
ERROR_NOT_READY
 DiskQuotaControl 对象未初始化。
E_INVALIDARG
 ppEnum 参数为 NULL。
E_OUTOFMEMORY
 内存不足。
E_UNEXPECTED
 发生意外异常。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 dskquota.h
DLL Dskquota.dll

另请参阅

磁盘管理界面

磁盘配额

IDiskQuotaControl