Share via

ActiveDirectoryMembershipProvider.ChangePassword Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.Security
Assembly:
System.Web.dll

Modifica la password per l'utente specificato.

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

Parametri

username
String

Nome dell'utente di cui aggiornare la password.

oldPassword
String

Password corrente dell'utente specificato.

newPassword
String

Nuova password per l'utente specificato.

Restituisce

Boolean

true se l'aggiornamento della password è riuscito. In caso contrario, false.

Eccezioni

ArgumentException

username è vuoto oppure supera la lunghezza massima per il nome utente (in genere 256 caratteri).

-oppure-

username contiene virgole.

-oppure-

Il nome utente è mappato sull'attributo userPrincipalName e il parametro username contiene barre rovesciate.

-oppure-

oldPassword oppure newPassword è una stringa di lunghezza zero.

-oppure-

oldPassword oppure newPassword supera la lunghezza massima della password (in genere 128 caratteri).

-oppure-

La lunghezza del parametro newPassword è inferiore alla lunghezza minima della password specificata nella proprietà MinRequiredPasswordLength.

-oppure-

Il numero di caratteri non alfabetici contenuti nel parametro newPassword è inferiore al valore specificato nella proprietà MinRequiredNonAlphanumericCharacters.

-oppure-

Il parametro newPassword non supera i criteri di convalida dell'espressione regolare definita nella proprietà PasswordStrengthRegularExpression.

ArgumentNullException

username è null.

-oppure-

oldPassword è null.

-oppure-

newPassword è null.

MembershipPasswordException

Il parametro newPassword non soddisfa i criteri di complessità definiti dal server Active Directory.

ProviderException

Non è stato possibile stabilire una connessione sicura con un server Active Directory Application Mode.

InvalidOperationException

Il metodo ChangePassword(String, String, String) viene chiamato prima che venga inizializzata l'istanza della classe ActiveDirectoryMembershipProvider.

Exception

Eccezione non gestita.

Commenti

Il ChangePassword metodo viene usato per aggiornare la password dell'utente nell'archivio dati di Active Directory. Indipendentemente dalle credenziali che l'istanza è configurata per l'uso ActiveDirectoryMembershipProvider , il provider si connette al server Active Directory usando i username parametri e oldPassword come credenziali di connessione.

Se la proprietà è , l'utente non può modificare la EnablePasswordReset password se l'account è truestato bloccato in precedenza perché l'utente ha effettuato troppi tentativi di rispondere alla domanda della password. L'utente dovrà attendere il numero di minuti specificati nella PasswordAnswerAttemptLockoutDuration proprietà prima di modificare la password.

Se la modifica della password ha esito positivo e la EnablePasswordReset proprietà è true, i contatori di rilevamento delle risposte password non valido dell'utente vengono reimpostati.

Il provider trova l'istanza dell'utente da aggiornare eseguendo una ricerca sottoalbero per il nome utente a partire dal punto di ricerca specificato nella stringa di connessione. Per altre informazioni sulle stringhe di connessione, vedere l'argomento ActiveDirectoryMembershipProvider della classe.

Per modificare le password in un server Active Directory, l'attributo connectionProtection deve essere impostato su SignAndSeal.

Quando si usa un server ADAM, l'attributo può essere impostato su None, ma solo se si configura in modo esplicito il connectionProtection server ADAM per consentire la modifica della password sulle connessioni non protette.

Si applica a

Vedi anche