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

Метод DiskQuotaControl.TranslateLogonNameToSID

  • Статья

Преобразует имя входа в соответствующий идентификатор безопасности пользователя в строковом формате.

Синтаксис

DiskQuotaControl.TranslateLogonNameToSID(
  logonname
)

Параметры

имя входа

Тип: Строка

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

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

Возвращает идентификатор безопасности пользователя (SID) в строковом формате, соответствующем указанному имени входа. Возвращаемая строка включает стандартные фигурные скобки. Пример:

"{S-1-5-21-2127521184-1604012920-1887927527-19009}"

Комментарии

Возвращаемую строку sid можно передать в метод FindUser вместо имени входа.

Если вызов метода FindUser( logonname) завершается сбоем, это может быть вызвано несоответствием между формой (например, совместимым с диспетчером учетных записей безопасности [SAM] и именем участника-пользователя [UPN]) предоставленного имени входа и формой, хранящейся в кэше sid-name. В таких случаях имя входа можно преобразовать в идентификатор безопасности, а вызов FindUser повторить. FindUser распознает строку идентификатора безопасности и будет обходить поиск в кэше sid-name. Следующий код Microsoft Visual Basic Scripting Edition (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

Преобразование имен в sid может быть медленным процессом по сравнению с поиском в кэше sid-name. Поэтому рекомендуется сначала вызвать FindUser с именем входа. В приведенном выше примере используется этот метод.

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
DLL
Shell32.dll (версия 5.0 или более поздняя)

См. также раздел

Объект DiskQuotaControl