ActiveDirectoryMembershipProvider.ChangePassword Método

Definición

Espacio de nombres:

System.Web.Security

Ensamblado:

System.Web.dll

Cambia la contraseña del usuario especificado.

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

Parámetros

username

String

Nombre del usuario cuya contraseña se va a actualizar.

oldPassword

String

Contraseña actual del usuario especificado.

newPassword

String

Nueva contraseña del usuario especificado.

Devoluciones

Boolean

true si la contraseña se ha actualizado correctamente; de lo contrario, false.

Excepciones

ArgumentException

username está vacío o supera la longitud máxima del nombre de usuario (normalmente 256 caracteres).

o bien

username contiene comas.

o bien

El nombre de usuario está asignado al atributo userPrincipalName y el parámetro username contiene barras diagonales inversas.

o bien

oldPassword o newPassword es una cadena de longitud cero.

o bien

oldPassword o newPassword superan la longitud máxima de contraseña (normalmente 128 caracteres).

o bien

newPassword es menor que el tamaño mínimo de contraseña especificado en la propiedad MinRequiredPasswordLength

o bien

newPassword contiene menos caracteres no alfabéticos que el número especificado en la propiedad MinRequiredNonAlphanumericCharacters.

o bien

newPassword no pasa la validación de la expresión regular definida en la propiedad PasswordStrengthRegularExpression.

ArgumentNullException

username es null.

o bien

oldPassword es null.

o bien

newPassword es null.

MembershipPasswordException

newPassword no cumple los requisitos de complejidad definidos por el servidor Active Directory.

ProviderException

No se ha podido realizar una conexión segura con un servidor Active Directory Application Mode.

InvalidOperationException

Se llama al método ChangePassword(String, String, String) antes de que se inicializa la instancia de ActiveDirectoryMembershipProvider.

Exception

Se produjo una excepción no controlada.

Comentarios

El ChangePassword método se usa para actualizar la contraseña del usuario en el almacén de datos de Active Directory. Independientemente de las credenciales que la ActiveDirectoryMembershipProvider instancia esté configurada para usar, el proveedor se conecta al servidor de Active Directory mediante los username parámetros y oldPassword como credenciales de conexión.

Si la EnablePasswordReset propiedad es true, el usuario no puede cambiar su contraseña si la cuenta se bloqueó anteriormente porque el usuario realizó demasiados intentos de responder a la pregunta de contraseña. El usuario deberá esperar el número de minutos especificados en la PasswordAnswerAttemptLockoutDuration propiedad antes de cambiar la contraseña.

Si el cambio de contraseña se realiza correctamente y la EnablePasswordReset propiedad es true, se restablecen los contadores de seguimiento de respuestas de contraseña incorrectas del usuario.

El proveedor busca la instancia de usuario que se va a actualizar realizando una búsqueda de subárbol para el nombre de usuario que comienza en el punto de búsqueda especificado en la cadena de conexión. Consulte el tema de la ActiveDirectoryMembershipProvider clase para obtener más información sobre las cadenas de conexión.

Para cambiar las contraseñas en un servidor de Active Directory, el connectionProtection atributo debe establecerse SignAndSealen .

Cuando se usa un servidor ADAM, el connectionProtection atributo se puede establecer Noneen , pero solo si configura explícitamente el servidor ADAM para permitir el cambio de contraseña en las conexiones no seguras.

Consulte también

• Introducción a la pertenencia a ASP.NET