ActiveDirectoryMembershipProvider.ChangePassword Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit le mot de passe de l'utilisateur spécifié.
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 BooleanParamètres
- username
- String
Nom de l'utilisateur dont le mot de passe doit être mis à jour.
- oldPassword
- String
Mot de passe actuel de l’utilisateur spécifié.
- newPassword
- String
Nouveau mot de passe de l’utilisateur spécifié.
Retours
true si le mot de passe a été correctement mis à jour ; sinon, false.
Exceptions
username est vide ou dépasse la longueur maximale autorisée pour le nom d'utilisateur (généralement 256 caractères).
- ou -
username contient des virgules.
- ou -
Le nom d'utilisateur est mappé à l'attribut userPrincipalName et le paramètre username contient des barres obliques inverses.
- ou -
oldPassword ou newPassword est une chaîne de longueur nulle.
- ou -
oldPassword ou newPassword dépasse la longueur maximale autorisée pour le mot de passe (généralement 128 caractères).
- ou -
newPassword contient moins de caractères que la taille minimale spécifiée pour le mot de passe dans la propriété MinRequiredPasswordLength
- ou -
newPassword contient moins de caractères non alphabétiques que le nombre spécifié dans la propriété MinRequiredNonAlphanumericCharacters.
- ou -
newPassword n'est pas validé par l'expression régulière définie dans la propriété PasswordStrengthRegularExpression.
username a la valeur null.
-ou-
oldPassword a la valeur null.
-ou-
newPassword a la valeur null.
newPassword ne satisfait pas aux conditions requises pour la complexité définies par le serveur Active Directory.
Une connexion sécurisée n'a pas pu être établie à un serveur Active Directory en mode application.
La méthode ChangePassword(String, String, String) est appelée avant l'initialisation de l'instance de ActiveDirectoryMembershipProvider.
Une exception non gérée s'est produite.
Remarques
La ChangePassword méthode est utilisée pour mettre à jour le mot de passe de l’utilisateur dans le magasin de données Active Directory. Quelles que soient les informations d’identification que l’instance ActiveDirectoryMembershipProvider est configurée pour utiliser, le fournisseur se connecte au serveur Active Directory en utilisant les username paramètres et oldPassword comme informations d’identification de connexion.
Si la EnablePasswordReset propriété est true, l’utilisateur ne peut pas modifier son mot de passe si le compte était précédemment verrouillé, car l’utilisateur a fait trop de tentatives pour répondre à la question de mot de passe. L’utilisateur doit attendre le nombre de minutes spécifié dans la PasswordAnswerAttemptLockoutDuration propriété avant de modifier le mot de passe.
Si la modification du mot de passe réussit et que la EnablePasswordReset propriété est true, les compteurs de suivi de mot de passe incorrects de l’utilisateur sont réinitialisés.
Le fournisseur recherche l’instance utilisateur à mettre à jour en effectuant une recherche de sous-arborescence pour le nom d’utilisateur en commençant au point de recherche spécifié dans la chaîne de connexion. Pour plus d’informations sur les chaînes de connexion, consultez la ActiveDirectoryMembershipProvider rubrique de classe.
Pour modifier les mots de passe sur un serveur Active Directory, l’attribut connectionProtection doit être défini sur SignAndSeal.
Lorsque vous utilisez un serveur ADAM, l’attribut connectionProtection peut être défini sur None, mais uniquement si vous configurez explicitement le serveur ADAM pour autoriser la modification du mot de passe sur des connexions non sécurisées.
