ActiveDirectoryMembershipProvider.ChangePassword 메서드

정의

네임스페이스:

System.Web.Security

어셈블리:

System.Web.dll

지정한 사용자의 암호를 변경합니다.

public:
 override bool ChangePassword(System::String ^ username, System::String ^ oldPassword, System::String ^ newPassword);

public override bool ChangePassword (string username, string oldPassword, string newPassword);

override this.ChangePassword : string * string * string -> bool

Public Overrides Function ChangePassword (username As String, oldPassword As String, newPassword As String) As Boolean

매개 변수

username

String

암호를 업데이트할 사용자의 이름입니다.

oldPassword

String

지정된 사용자의 현재 암호입니다.

newPassword

String

지정된 사용자의 새 암호입니다.

반환

Boolean

암호가 성공적으로 업데이트되었으면 true이고, 그렇지 않으면 false입니다.

예외

ArgumentException

username이 비어 있거나 사용자 이름의 최대 길이(대개 256자)를 초과하는 경우

또는

username에 쉼표가 포함된 경우

또는

사용자 이름이 userPrincipalName 특성에 매핑되고 username 매개 변수에 백슬래시가 포함된 경우

또는

oldPassword 또는 newPassword가 길이가 0인 문자열인 경우

또는

oldPassword 또는 newPassword가 최대 암호 길이(대개 128자)를 초과하는 경우

또는

newPassword가 MinRequiredPasswordLength 속성에 지정된 최소 암호 길이보다 짧은 경우

또는

newPassword에서 영문자가 아닌 문자 수가 MinRequiredNonAlphanumericCharacters 속성에 지정된 수보다 적은 경우

또는

newPassword가 PasswordStrengthRegularExpression 속성에 정의된 정규식을 사용한 유효성 검사에 실패하는 경우

ArgumentNullException

username이(가) null인 경우

또는

oldPassword은 null입니다.

또는

newPassword이(가) null인 경우

MembershipPasswordException

newPassword가 Active Directory 서버에서 정의한 복잡성 요구 사항에 맞지 않는 경우

ProviderException

Active Directory 애플리케이션 모드 서버에 대한 보안 연결을 만들 수 없는 경우

InvalidOperationException

ChangePassword(String, String, String) 인스턴스가 초기화되기 전에 ActiveDirectoryMembershipProvider 메서드가 호출된 경우

Exception

처리되지 않은 예외가 발생했습니다.

설명

메서드는 ChangePassword Active Directory 데이터 저장소에서 사용자의 암호를 업데이트하는 데 사용됩니다. 인스턴스가 ActiveDirectoryMembershipProvider 사용하도록 구성된 자격 증명에 관계없이 공급자는 및 oldPassword 매개 변수를 연결 자격 증명으로 사용하여 username Active Directory 서버에 연결합니다.

속성이 true인 EnablePasswordReset 경우 사용자가 암호 질문에 대답하기 위해 너무 많은 시도를 했기 때문에 계정이 이전에 잠긴 경우 사용자가 암호를 변경할 수 없습니다. 사용자는 암호를 변경하기 전에 속성에 지정된 시간(분)을 PasswordAnswerAttemptLockoutDuration 기다려야 합니다.

암호 변경에 성공하고 속성이 EnablePasswordResettrue이면 사용자의 잘못된 암호 응답 추적 카운터가 다시 설정됩니다.

공급자는 연결 문자열에 지정된 검색 지점에서 시작하여 사용자 이름에 대한 하위 트리 검색을 수행하여 업데이트할 사용자 인스턴스를 찾습니다. 연결 문자열에 ActiveDirectoryMembershipProvider 대한 자세한 내용은 클래스 항목을 참조하세요.

Active Directory 서버 connectionProtection 에서 암호를 변경하려면 특성을 로 설정 SignAndSeal해야 합니다.

ADAM 서버를 사용하는 경우 특성은 connectionProtection 으로 None설정할 수 있지만 보안되지 않은 연결에 대한 암호 변경을 허용하도록 ADAM 서버를 명시적으로 구성하는 경우에만 설정할 수 있습니다.

추가 정보

• ASP.NET 멤버 자격 소개