IDiskQuotaControl::FindUserName 方法 (dskquota.h)

在卷配额信息中找到特定条目。 用户的帐户登录名用作搜索密钥。

语法

HRESULT FindUserName(
  [in]  LPCWSTR         pszLogonName,
  [out] PDISKQUOTA_USER *ppUser
);

参数

[in] pszLogonName

指向用户帐户登录名的指针。

[out] ppUser

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

返回值

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

返回代码 说明
S_OK
成功。
ERROR_ACCESS_DENIED
调用方没有足够的访问权限。
ERROR_INVALID_SID
用户的 SID 无效。
ERROR_NONE_MAPPED
没有可用于 SID 的映射。
ERROR_NOT_READY
DiskQuotaControl 对象未初始化。
E_INVALIDARG
pUserSidppUser 参数为 NULL
E_OUTOFMEMORY
内存不足。
E_FAIL
发生意外的文件系统错误。
E_UNEXPECTED
发生意外异常。

备注

即使配额文件中没有用户配额记录,此方法也会返回用户对象。 这与自动添加用户和默认配额设置的想法一致。 如果请求的用户当前没有配额条目,并且如果用户要请求磁盘空间,则会将其添加到配额文件,则返回的用户对象将具有与卷默认设置相等的警告阈值和硬配额限制。

要求

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

请参阅

磁盘管理界面

磁盘配额

IDiskQuotaControl