ActiveDirectoryMembershipProvider.UnlockUser(String) Método

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Limpa um bloqueio de modo que um usuário associado possa ser validado.

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

Parâmetros

username

String

O nome do usuário associado para o qual limpar o status de bloqueio.

Retornos

Boolean

true se o usuário associado tiver sido desbloqueado com sucesso; caso contrário, false. O método UnlockUser(String) também retorna false quando o usuário associado não é encontrado no armazenamento de dados.

Exceções

ArgumentException

username está vazio ou excede o comprimento máximo permitido para nomes de usuário (normalmente 256 caracteres).

- ou -

username contém vírgulas.

- ou -

O nome de usuário é mapeado para userPrincipalName, mas o parâmetro username contém barras invertidas.

ArgumentNullException

username é null.

InvalidOperationException

O método UnlockUser(String) é chamado antes que a instância ActiveDirectoryMembershipProvider seja inicializada.

Comentários

Os usuários geralmente são bloqueados e não podem ser validados pelo ValidateUser método quando a MaxInvalidPasswordAttempts propriedade é excedida dentro do tempo especificado na PasswordAttemptWindow propriedade ou quando muitas tentativas foram feitas para fazer logon usando a senha errada.

Se a EnablePasswordReset propriedade for true, quando um usuário for desbloqueado, os contadores para senhas incorretas serão redefinidos.

O provedor usa uma pesquisa de subárvore começando no ponto de pesquisa especificado na cadeia de conexão. Consulte o tópico de ActiveDirectoryMembershipProvider classe para obter mais informações sobre cadeias de conexão.

Os espaços à esquerda e à direita são cortados do valor de parâmetro username.

Confira também

• Introdução à associação de ASP.NET