通过

DiskQuotaControl.FindUser 方法

  • 项目

在卷的配额文件中按名称查找用户的条目。

语法

DiskQuotaControl.FindUser(
  sLogonName
)

parameters

sLogonName

类型： 字符串

包含用户登录名的字符串值。

返回值

返回一个对象表达式，该表达式的计算结果为用户的 DIDiskQuotaUser 对象。

备注

即使配额文件中没有用户条目，此方法也会返回 DIDiskQuotaUser 对象。 返回的用户对象具有设置为卷默认值的警告阈值和硬配额限制。

从 TranslateLogonNameToSID 返回的字符串可以传递来代替 sLogonName 参数。 当 FindUser 收到 SID 字符串时，它会使用相应的 SID 直接查找卷上的用户配额记录。 这会绕过 SID 名称缓存。 如果 FindUser 由于格式 (（例如 SAM 兼容和 UPN) 所提供的登录名和缓存的登录名）而失败，则可以使用 TranslateLogonNameToSID 将登录名转换为 SID 字符串，然后再次传递到 FindUser。 以下 VBScript 代码演示了此方法。

Function Find(dqc, name)
    On Error Resume Next
    SET Find = dqc.FindUser(name)

    If Err.Number <> 0 Then
        Err.Clear
        SET Find = dqc.FindUser(dqc.TranslateLogonNameToSID(name))
    End If    

End Function

要求

要求 值
最低受支持的客户端
 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
 Windows 2000 Server [仅限桌面应用]
DLL
Shell32.dll (5.0 或更高版本)

另请参阅

DiskQuotaControl 对象