ActiveDirectoryMembershipProvider.ChangePassword Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> boolPublic Overrides Function ChangePassword (username As String, oldPassword As String, newPassword As String) As BooleanParametri
- 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
true se l'aggiornamento della password è riuscito. In caso contrario, false.
Eccezioni
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.
Il parametro newPassword non soddisfa i criteri di complessità definiti dal server Active Directory.
Non è stato possibile stabilire una connessione sicura con un server Active Directory Application Mode.
Il metodo ChangePassword(String, String, String) viene chiamato prima che venga inizializzata l'istanza della classe ActiveDirectoryMembershipProvider.
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 EnablePasswordReset proprietà è true, l'utente non può modificare la password se l'account è stato bloccato in precedenza perché l'utente ha effettuato troppi tentativi di rispondere alla domanda della password. L'utente dovrà attendere il numero di minuti specificato 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 alle password non valido dell'utente vengono reimpostati.
Il provider trova l'istanza 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 relativo alla ActiveDirectoryMembershipProvider 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 connectionProtection può essere impostato su None, ma solo se si configura in modo esplicito il server ADAM per consentire la modifica della password su connessioni non protette.
