ActiveDirectoryMembershipProvider.ChangePassword Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> boolPublic Overrides Function ChangePassword (username As String, oldPassword As String, newPassword As String) As BooleanPará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
true si la contraseña se ha actualizado correctamente; de lo contrario, false.
Excepciones
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.
newPassword no cumple los requisitos de complejidad definidos por el servidor Active Directory.
No se ha podido realizar una conexión segura con un servidor Active Directory Application Mode.
Se llama al método ChangePassword(String, String, String) antes de que se inicializa la instancia de ActiveDirectoryMembershipProvider.
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 conexiones no seguras.
