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 接口指针的指针。

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

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