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, dessen 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
true, wenn das Kennwort erfolgreich aktualisiert wurde, andernfalls false.
Ausnahmen
username ist leer oder übersteigt die maximale Länge für den Benutzernamen (i. d. R. 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 Zeichenfolge der Länge 0 (null).
- oder -
oldPassword oder newPassword übersteigt die maximale Kennwortlänge (i. d. R.128 Zeichen).
- oder -
newPassword ist kleiner als die minimale in der MinRequiredPasswordLength-Eigenschaft angegebene Kennwortlänge.
- oder -
newPassword enthält weniger nichtalphabetische Zeichen als die in der MinRequiredNonAlphanumericCharacters-Eigenschaft angegebene Anzahl.
- oder -
newPassword wird bei der Validierung durch den regulären Ausdruck, der in der PasswordStrengthRegularExpression-Eigenschaft definiert ist, als ungültig erkannt.
username ist null.
- oder -
oldPassword ist null.
- oder -
newPassword ist null.
newPassword erfüllt nicht die durch den Active Directory-Server definierten Komplexitätsanforderungen.
Es konnte keine sichere Verbindung mit einem Active Directory Application Mode-Server hergestellt werden.
Die ChangePassword(String, String, String)-Methode wird aufgerufen, bevor die ActiveDirectoryMembershipProvider-Instanz initialisiert wird.
Unbehandelte Ausnahme.
Hinweise
Die ChangePassword -Methode wird verwendet, um das Kennwort des Benutzers im Active Directory-Datenspeicher zu aktualisieren. Unabhängig von den Anmeldeinformationen, für die die ActiveDirectoryMembershipProvider Instanz konfiguriert ist, stellt der Anbieter eine Verbindung mit dem Active Directory-Server her, wobei die username Parameter und oldPassword als Verbindungsanmeldeinformationen verwendet werden.
Wenn die EnablePasswordReset -Eigenschaft lautet true, kann der Benutzer sein Kennwort nicht ändern, wenn das Konto zuvor gesperrt war, weil 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 er das Kennwort ändert.
Wenn die Kennwortänderung erfolgreich ist und die EnablePasswordReset Eigenschaft lautet true, werden die Nachverfolgungsindikatoren für ungültige Kennwortantworten des Benutzers zurückgesetzt.
Der Anbieter sucht die zu aktualisierende Benutzerinstanz, indem er eine Unterstruktursuche nach dem Benutzernamen ab dem in der Verbindungszeichenfolge angegebenen Suchpunkt durchführt. Weitere Informationen zu Verbindungszeichenfolgen finden Sie im ActiveDirectoryMembershipProvider Klassenthema.
Zum Ändern von Kennwörtern auf einem Active Directory-Server muss das connectionProtection Attribut auf SignAndSealfestgelegt werden.
Wenn Sie einen ADAM-Server verwenden, kann das connectionProtection Attribut auf Nonefestgelegt werden, aber nur, wenn Sie den ADAM-Server explizit so konfigurieren, dass die Kennwortänderung über ungesicherte Verbindungen zulässig ist.
