ActiveDirectoryMembershipProvider.ChangePassword Méthode

Définition

Espace de noms:

System.Web.Security

Assembly:

System.Web.dll

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 -> bool

Public Overrides Function ChangePassword (username As String, oldPassword As String, newPassword As String) As Boolean

Paramè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

Boolean

true si le mot de passe a été correctement mis à jour ; sinon, false.

Exceptions

ArgumentException

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.

ArgumentNullException

username a la valeur null.

-ou-

oldPassword a la valeur null.

-ou-

newPassword a la valeur null.

MembershipPasswordException

newPassword ne satisfait pas aux conditions requises pour la complexité définies par le serveur Active Directory.

ProviderException

Une connexion sécurisée n'a pas pu être établie à un serveur Active Directory en mode application.

InvalidOperationException

La méthode ChangePassword(String, String, String) est appelée avant l'initialisation de l'instance de ActiveDirectoryMembershipProvider.

Exception

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 propriété a la EnablePasswordReset valeur true, l’utilisateur ne peut pas modifier son mot de passe si le compte a été précédemment verrouillé, car il a fait trop de tentatives pour répondre à la question du 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 le changement de mot de passe réussit et que la EnablePasswordReset propriété est true, les compteurs de suivi des réponses 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. Consultez la rubrique de ActiveDirectoryMembershipProvider classe pour plus d’informations sur les chaînes de connexion.

Pour modifier les mots de passe sur un serveur Active Directory, l’attribut connectionProtection doit être défini sur SignAndSeal.

Lors de l’utilisation d’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 les connexions non sécurisées.

Voir aussi

• Présentation de l’appartenance ASP.NET