ActiveDirectoryMembershipProvider.UnlockUser(String) Methode

  • Referenz

Definition

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

Hebt eine Sperre auf, sodass ein Mitgliedschaftsbenutzer überprüft werden kann.

public:
 override bool UnlockUser(System::String ^ username);
public override bool UnlockUser (string username);
override this.UnlockUser : string -> bool
Public Overrides Function UnlockUser (username As String) As Boolean

Parameter

username
String

Der Name des Mitgliedschaftsbenutzers, für den der Sperrstatus aufgehoben werden soll.

Gibt zurück

Boolean

true, wenn der Mitgliedschaftsbenutzer erfolgreich entsperrt wurde, andernfalls false. Die UnlockUser(String)-Methode gibt auch dann false zurück, wenn der Mitgliedschaftsbenutzer im Datenspeicher nicht gefunden wurde.

Ausnahmen

ArgumentException

username ist leer oder übersteigt die maximale für Benutzernamen zulässige Länge (i. d. R. 256 Zeichen).

- oder -

username enthält Kommas.

- oder -

Der Benutzername wird userPrincipalName zugeordnet, der username-Parameter enthält jedoch umgekehrte Schrägstriche.

ArgumentNullException

username ist null.

InvalidOperationException

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

Hinweise

Benutzer sind am häufigsten gesperrt und können von der ValidateUser -Methode nicht überprüft werden, wenn die MaxInvalidPasswordAttempts Eigenschaft innerhalb der in der PasswordAttemptWindow Eigenschaft angegebenen Zeit überschritten wird oder wenn zu viele Versuche unternommen wurden, sich mit dem falschen Kennwort anzumelden.

Wenn die EnablePasswordReset -Eigenschaft ist true, werden die Leistungsindikatoren für ungültige Kennwörter zurückgesetzt, wenn ein Benutzer entsperrt wird.

Der Anbieter verwendet eine Unterstruktursuche, die an dem in der Verbindungszeichenfolge angegebenen Suchpunkt beginnt. Weitere Informationen zu Verbindungszeichenfolgen finden Sie im ActiveDirectoryMembershipProvider Thema der -Klasse.

Beim username-Parameterwert werden führende und nachstehende Leerzeichen abgeschnitten.

Gilt für:

Weitere Informationen