ActiveDirectoryMembershipProvider.ChangePassword Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ändert das Kennwort für den angegebenen Benutzer.
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 BooleanParameter
- username
- String
Der Name des Benutzers, für den das Kennwort aktualisiert werden soll.
- oldPassword
- String
Das aktuelle Kennwort für den angegebenen Benutzer.
- newPassword
- String
Das neue Kennwort für den angegebenen Benutzer.
Gibt zurück
truewenn das Kennwort erfolgreich aktualisiert wurde; andernfalls . false
Ausnahmen
username ist leer oder überschreitet die maximale Länge für den Benutzernamen (normalerweise 256 Zeichen).
- oder -
username enthält Kommas.
- oder -
Der Benutzername wird dem userPrincipalName Attribut zugeordnet, und der username Parameter enthält umgekehrte Schrägstriche.
- oder -
oldPassword oder newPassword ist eine leere Zeichenfolge.
- oder -
oldPassword oder newPassword überschreitet die maximale Kennwortlänge (in der Regel 128 Zeichen).
- oder -
newPassword ist kleiner als die in der MinRequiredPasswordLength Eigenschaft angegebene Mindestkennwortgröße.
- oder -
newPassword enthält weniger als die Anzahl nicht alphabetischer Zeichen, die in der MinRequiredNonAlphanumericCharacters Eigenschaft angegeben sind.
- oder -
newPassword die Überprüfung durch den in der PasswordStrengthRegularExpression Eigenschaft definierten regulären Ausdruck fehlschlägt.
username ist null.
- oder -
oldPassword ist null.
- oder -
newPassword ist null.
newPassword erfüllt nicht die vom Active Directory-Server definierten Komplexitätsanforderungen.
Eine sichere Verbindung konnte nicht an einen Active Directory-Anwendungsmodusserver hergestellt werden.
Die ChangePassword(String, String, String) Methode wird aufgerufen, bevor die ActiveDirectoryMembershipProvider Instanz initialisiert wird.
Es ist eine unbehandelte Ausnahme aufgetreten.
Hinweise
Die ChangePassword Methode wird verwendet, um das Kennwort des Benutzers im Active Directory-Datenspeicher zu aktualisieren. Unabhängig von den Anmeldeinformationen, die die Instanz für die ActiveDirectoryMembershipProvider Verwendung konfiguriert ist, stellt der Anbieter eine Verbindung mit dem Active Directory-Server her, wobei die usernameoldPassword Parameter als Verbindungsanmeldeinformationen verwendet werden.
Wenn die EnablePasswordReset Eigenschaft lautet true, kann der Benutzer sein Kennwort nicht ändern, wenn das Konto zuvor gesperrt wurde, da der Benutzer zu viele Versuche unternommen hat, die Kennwortfrage zu beantworten. Der Benutzer muss die in der PasswordAnswerAttemptLockoutDuration Eigenschaft angegebene Anzahl von Minuten warten, bevor das Kennwort geändert wird.
Wenn die Kennwortänderung erfolgreich ist und die EnablePasswordReset Eigenschaft truelautet, werden die Nachverfolgungsindikatoren für ungültige Kennwörter des Benutzers zurückgesetzt.
Der Anbieter findet die zu aktualisierende Benutzerinstanz, indem eine Unterstruktursuche für den Benutzernamen ausgeführt wird, beginnend mit dem in der Verbindungszeichenfolge angegebenen Suchpunkt. Weitere Informationen zu Verbindungszeichenfolgen finden Sie im ActiveDirectoryMembershipProvider Klassenthema.
Um Kennwörter auf einem Active Directory-Server zu ändern, muss das connectionProtection Attribut auf SignAndSeal.
Wenn Sie einen ADAM-Server verwenden, kann das connectionProtection Attribut auf festgelegt Nonewerden, aber nur, wenn Sie den ADAM-Server explizit so konfigurieren, dass kennwortänderung über ungesicherte Verbindungen zulässig ist.
