Поделиться через

Метод DiskQuotaControl.FindUser

  • Статья

Находит запись пользователя по имени в файле квоты тома.

Синтаксис

DiskQuotaControl.FindUser(
  sLogonName
)

Параметры

sLogonName

Тип: String

Строковое значение, содержащее имя пользователя для входа.

Возвращаемое значение

Возвращает выражение объекта, результатом которого является объект DIDiskQuotaUser пользователя.

Комментарии

Этот метод возвращает объект DIDiskQuotaUser , даже если в файле квоты нет записи для пользователя. Возвращаемый объект пользователя имеет пороговое значение предупреждения и жесткие ограничения квоты, установленные для значений тома по умолчанию.

Строка, возвращаемая из TranslateLogonNameToSID , может быть передана вместо параметра sLogonName . Когда FindUser получает строку идентификатора безопасности, он использует соответствующий идентификатор безопасности для прямого поиска записи квоты пользователя на томе. Это обходит кэш sid-name. В случаях, когда FindUser завершается сбоем из-за несоответствия формата (например, совместимого с SAM и имени участника-пользователя) предоставленного имени входа и кэшированного имени входа, имя входа можно преобразовать в строку sid с помощью TranslateLogonNameToSID , а затем снова передать в 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