ActiveDirectoryMembershipProvider.ChangePassword Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> boolPublic Overrides Function ChangePassword (username As String, oldPassword As String, newPassword As String) As BooleanParametry
- 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 .
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.
