다음을 통해 공유

DiskQuotaControl.FindUser 메서드

  • 아티클

볼륨의 할당량 파일에서 이름별로 사용자의 항목을 찾습니다.

구문

DiskQuotaControl.FindUser(
  sLogonName
)

매개 변수

sLogonName

형식: 문자열

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

반환 값

사용자의 DIDiskQuotaUser 개체로 계산되는 개체 식을 반환합니다.

설명

이 메서드는 할당량 파일에 사용자에 대한 항목이 없더라도 DIDiskQuotaUser 개체를 반환합니다. 반환된 사용자 개체에는 경고 임계값과 하드 할당량 제한이 볼륨의 기본값으로 설정됩니다.

TranslateLogonNameToSID에서 반환된 문자열은 sLogonName 매개 변수 대신 전달될 수 있습니다. FindUser가 SID 문자열을 받으면 해당 SID를 사용하여 볼륨에서 사용자의 할당량 레코드를 직접 조회합니다. 그러면 SID 이름 캐시가 무시됩니다. 제공된 로그온 이름의 형식(예: SAM 호환 및 UPN)이 일치하지 않아 FindUser 가 실패하고 로그온 이름이 캐시된 경우 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 개체