Share via

ActiveDirectoryMembershipProvider.ChangePassword Methode

  • Referenz

Definition

Namespace:
System.Web.Security
Assembly:
System.Web.dll

Ä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 -> bool
Public Overrides Function ChangePassword (username As String, oldPassword As String, newPassword As String) As Boolean

Parameter

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

Boolean

true, wenn das Kennwort erfolgreich aktualisiert wurde, andernfalls false.

Ausnahmen

ArgumentException

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.

ArgumentNullException

username ist null.

- oder -

oldPassword ist null.

- oder -

newPassword ist null.

MembershipPasswordException

newPassword erfüllt nicht die durch den Active Directory-Server definierten Komplexitätsanforderungen.

ProviderException

Es konnte keine sichere Verbindung mit einem Active Directory Application Mode-Server hergestellt werden.

InvalidOperationException

Die ChangePassword(String, String, String)-Methode wird aufgerufen, bevor die ActiveDirectoryMembershipProvider-Instanz initialisiert wird.

Exception

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 Antwortindikatoren für ungültige Kennwörter 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.

Gilt für:

Weitere Informationen