通过

IDiskQuotaControl：：AddUserName 方法 (dskquota.h)

  • 项目

在卷上为指定用户添加新的配额条目。 用户由域和帐户名称标识。

语法

HRESULT AddUserName(
  [in]  LPCWSTR         pszLogonName,
  [in]  DWORD           fNameResolution,
  [out] PDISKQUOTA_USER *ppUser
);

参数

[in] pszLogonName

用户的帐户登录名字符串。

[in] fNameResolution

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

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

[out] ppUser

指向新创建的配额用户对象的 IDiskQuotaUser 接口指针的指针。

返回值

此方法返回文件系统错误或以下值之一。

返回代码 说明
S_OK
 成功。
S_FALSE
 用户已存在。 未添加。
ERROR_NOT_READY
 DiskQuotaControl 对象未初始化。
ERROR_USER_UNKNOWN
 指定的用户名未知。
E_INVALIDARG
 指针参数为 NULL。
E_OUTOFMEMORY
 内存不足。
E_FAIL
 发生意外的文件系统错误。
E_UNEXPECTED
 发生意外异常。

备注

当用户首次写入到卷时，NTFS 文件系统会自动创建一个用户配额条目。 将为自动创建的条目分配卷的默认警告阈值和硬配额限制值。 此方法允许在用户将信息写入卷之前创建用户配额条目。 因此，可以预先分配不同于卷默认设置的警告阈值或硬配额限制值。

要求

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

请参阅

磁盘管理界面

磁盘配额

IDiskQuotaControl