Udostępnij za pośrednictwem


ActiveDirectoryMembershipProvider.ChangePassword Metoda

Definicja

Zmienia hasło określonego użytkownika.

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

Parametry

username
String

Nazwa użytkownika do zaktualizowania hasła.

oldPassword
String

Bieżące hasło dla określonego użytkownika.

newPassword
String

Nowe hasło dla określonego użytkownika.

Zwraca

true jeśli hasło zostało pomyślnie zaktualizowane; w przeciwnym razie , false.

Wyjątki

username jest pusta lub przekracza maksymalną długość nazwy użytkownika (zwykle 256 znaków).

-lub-

username zawiera przecinki.

-lub-

Nazwa użytkownika jest mapowana na userPrincipalName atrybut, a username parametr zawiera ukośniki odwrotne.

-lub-

oldPassword lub newPassword jest ciągiem o zerowej długości.

-lub-

oldPassword lub newPassword przekracza maksymalną długość hasła (zazwyczaj 128 znaków).

-lub-

newPassword jest mniejszy niż minimalny rozmiar hasła określony we MinRequiredPasswordLength właściwości

-lub-

newPassword zawiera mniej niż liczba znaków innych niż alfabetyczne określone we MinRequiredNonAlphanumericCharacters właściwości .

-lub-

newPassword Niepowodzenie walidacji przez wyrażenie regularne zdefiniowane we PasswordStrengthRegularExpression właściwości .

username to null.

-lub-

oldPassword to null.

-lub-

newPassword to null.

newPassword program nie spełnia wymagań dotyczących złożoności zdefiniowanych przez serwer usługi Active Directory.

Nie można nawiązać bezpiecznego połączenia z serwerem trybu aplikacji usługi Active Directory.

Metoda jest wywoływana ChangePassword(String, String, String) przed zainicjowanym wystąpieniem ActiveDirectoryMembershipProvider .

Wystąpił nieobsługiwany wyjątek.

Uwagi

Metoda ChangePassword służy do aktualizowania hasła użytkownika w magazynie danych usługi Active Directory. Niezależnie od poświadczeń skonfigurowanych ActiveDirectoryMembershipProvider do użycia przez wystąpienie dostawca łączy się z serwerem usługi Active Directory przy użyciu username parametrów i oldPassword jako poświadczeń połączenia.

EnablePasswordReset Jeśli właściwość ma truewartość , użytkownik nie może zmienić hasła, jeśli konto zostało wcześniej zablokowane, ponieważ użytkownik podjął zbyt wiele prób udzielenia odpowiedzi na pytanie dotyczące hasła. Użytkownik będzie musiał poczekać liczbę minut określonych we PasswordAnswerAttemptLockoutDuration właściwości przed zmianą hasła.

Jeśli zmiana hasła powiedzie się, a EnablePasswordReset właściwość ma truewartość , liczniki śledzenia odpowiedzi na nieprawidłowe hasła użytkownika zostaną zresetowane.

Dostawca znajduje wystąpienie użytkownika do zaktualizowania, wykonując poddrzewo wyszukiwania nazwy użytkownika, zaczynając od punktu wyszukiwania określonego w parametrach połączenia. Zobacz temat klasy, ActiveDirectoryMembershipProvider aby uzyskać więcej informacji na temat parametrów połączenia.

Aby zmienić hasła na serwerze usługi Active Directory, connectionProtection atrybut musi być ustawiony na SignAndSeal.

W przypadku korzystania z serwera ADAM atrybut można ustawić na None, ale tylko wtedy, connectionProtection gdy jawnie skonfigurujesz serwer ADAM, aby zezwolić na zmianę hasła w niezabezpieczonych połączeniach.

Dotyczy

Zobacz też