다음을 통해 공유

DiskQuotaControl.TranslateLogonNameToSID 메서드

  • 아티클

로그온 이름을 문자열 형식의 해당 사용자 보안 ID로 변환합니다.

구문

DiskQuotaControl.TranslateLogonNameToSID(
  logonname
)

매개 변수

logonname

형식: 문자열

사용자의 로그온 이름을 지정하는 문자열 값입니다.

반환 값

제공된 로그온 이름에 해당하는 문자열 형식으로 SID(사용자 보안 ID)를 반환합니다. 반환된 문자열에는 표준 바깥쪽 중괄호가 포함됩니다. 예:

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

설명

반환된 SID 문자열을 로그온 이름 대신 FindUser 메서드에 전달할 수 있습니다.

FindUser( logonname) 메서드에 대한 호출이 실패하면 제공된 로그온 이름과 SID 이름 캐시에 저장된 양식의 양식(예: 보안 계정 관리자 [SAM] 호환 및 사용자 계정 이름 [UPN])이 일치하지 않을 수 있습니다. 이러한 경우 로그온 이름을 SID로 변환하고 FindUser 에 대한 호출을 반복할 수 있습니다. FindUser 는 SID 문자열을 인식하고 SID 이름 캐시 조회를 무시합니다. 다음 Microsoft VBScript(Visual Basic Scripting Edition) 코드는 이 기술을 보여 줍니다.

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 변환은 느린 프로세스일 수 있습니다. 따라서 FindUser 를 먼저 로그온 이름으로 호출하는 것이 좋습니다. 위의 예제에서는 이 기술을 사용합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003 [데스크톱 앱만 해당]
DLL
Shell32.dll(버전 5.0 이상)

추가 정보

DiskQuotaControl 개체