IDiskQuotaControl::FindUserName 方法 (dskquota.h)
在卷配额信息中找到特定条目。 用户的帐户登录名用作搜索密钥。
语法
HRESULT FindUserName(
[in] LPCWSTR pszLogonName,
[out] PDISKQUOTA_USER *ppUser
);
参数
[in] pszLogonName
指向用户帐户登录名的指针。
[out] ppUser
指向指向配额用户对象的 IDiskQuotaUser 接口指针的指针。
返回值
此方法返回文件系统错误或以下值之一。
返回代码 | 说明 |
---|---|
|
成功。 |
|
调用方没有足够的访问权限。 |
|
用户的 SID 无效。 |
|
没有可用于 SID 的映射。 |
|
DiskQuotaControl 对象未初始化。 |
|
pUserSid 或 ppUser 参数为 NULL。 |
|
内存不足。 |
|
发生意外的文件系统错误。 |
|
发生意外异常。 |
备注
即使配额文件中没有用户配额记录,此方法也会返回用户对象。 这与自动添加用户和默认配额设置的想法一致。 如果请求的用户当前没有配额条目,并且如果用户要请求磁盘空间,则会将其添加到配额文件,则返回的用户对象将具有与卷默认设置相等的警告阈值和硬配额限制。
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | dskquota.h |
DLL | Dskquota.dll |