ActiveDirectoryMembershipProvider.ChangePassword Metod

Definition

Namnområde:
System.Web.Security
Sammansättning:
System.Web.dll

Ändrar lösenordet för den angivna användaren.

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

Parametrar

username
String

Namnet på användaren som lösenordet ska uppdateras för.

oldPassword
String

Det aktuella lösenordet för den angivna användaren.

newPassword
String

Det nya lösenordet för den angivna användaren.

Returer

Boolean

trueom lösenordet har uppdaterats. annars . false

Undantag

ArgumentException

username är tom eller överskrider den maximala längden för användarnamnet (vanligtvis 256 tecken).

-eller-

username innehåller kommatecken.

-eller-

Användarnamnet mappas till userPrincipalName attributet och parametern username innehåller omvänt snedstreck.

-eller-

oldPassword eller newPassword är en sträng med noll längd.

-eller-

oldPassword eller newPassword överskrider den maximala lösenordslängden (vanligtvis 128 tecken).

-eller-

newPassword är mindre än den minsta lösenordsstorlek som MinRequiredPasswordLength anges i egenskapen

-eller-

newPassword innehåller färre än antalet icke-alfabetiska tecken som anges i egenskapen MinRequiredNonAlphanumericCharacters .

-eller-

newPassword misslyckas med valideringen av det reguljära uttryck som definierats i PasswordStrengthRegularExpression egenskapen.

ArgumentNullException

username är null.

-eller-

oldPassword är null.

-eller-

newPassword är null.

MembershipPasswordException

newPassword uppfyller inte de komplexitetskrav som definieras av služba Active Directory-servern.

ProviderException

Det gick inte att upprätta en säker anslutning till en služba Active Directory programlägesserver.

InvalidOperationException

Metoden ChangePassword(String, String, String) anropas innan instansen ActiveDirectoryMembershipProvider initieras.

Exception

Ett ohanterat undantag inträffade.

Kommentarer

Metoden ChangePassword används för att uppdatera användarens lösenord i služba Active Directory datalagret. Oavsett vilka autentiseringsuppgifter som ActiveDirectoryMembershipProvider-instansen är konfigurerad att använda ansluter providern till služba Active Directory-servern med parametrarna username och oldPassword som autentiseringsuppgifter för anslutningen.

Om egenskapen EnablePasswordReset är truekan användaren inte ändra sitt lösenord om kontot tidigare var låst eftersom användaren gjorde för många försök att besvara lösenordsfrågan. Användaren måste vänta det antal minuter som anges i PasswordAnswerAttemptLockoutDuration egenskapen innan lösenordet ändras.

Om lösenordsändringen EnablePasswordReset lyckas och egenskapen är trueåterställs användarens felaktiga svarsspårningsräknare för lösenord.

Providern hittar den användarinstans som ska uppdateras genom att utföra en underträdssökning efter användarnamnet från den sökpunkt som anges i reťazec pripojenia. Mer information om anslutningssträngar finns i ActiveDirectoryMembershipProvider klassavsnittet.

Om du vill ändra lösenord på en služba Active Directory server måste attributet connectionProtection anges till SignAndSeal.

När du använder en ADAM-server connectionProtection kan attributet anges till None, men bara om du uttryckligen konfigurerar ADAM-servern för att tillåta lösenordsändring över oskyddade anslutningar.

Gäller för

Se även