ActiveDirectoryMembershipProvider.ChangePassword Metoda

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.dll

Změní heslo pro zadaného uživatele.

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

Parametry

username

String

Jméno uživatele, pro který se má heslo aktualizovat.

oldPassword

String

Aktuální heslo pro zadaného uživatele.

newPassword

String

Nové heslo pro zadaného uživatele.

Návraty

Boolean

truepokud heslo bylo úspěšně aktualizováno; v opačném případě . false

Výjimky

ArgumentException

username je prázdné nebo překračuje maximální délku uživatelského jména (obvykle 256 znaků).

-nebo-

username obsahuje čárky.

-nebo-

Uživatelské jméno se mapuje na userPrincipalName atribut a username parametr obsahuje zpětná lomítka.

-nebo-

oldPassword nebo newPassword je řetězec nulové délky.

-nebo-

oldPassword nebo newPassword překračuje maximální délku hesla (obvykle 128 znaků).

-nebo-

newPassword je menší než minimální velikost hesla zadaná ve MinRequiredPasswordLength vlastnosti

-nebo-

newPassword obsahuje méně než počet nea abecedních znaků zadaných MinRequiredNonAlphanumericCharacters ve vlastnosti .

-nebo-

newPassword selže při ověřování regulárním výrazem definovaným PasswordStrengthRegularExpression ve vlastnosti .

ArgumentNullException

username je null.

-nebo-

oldPassword je null.

-nebo-

newPassword je null.

MembershipPasswordException

newPassword nesplňuje požadavky na složitost definované serverem služby Active Directory.

ProviderException

Nelze vytvořit zabezpečené připojení k serveru režimu aplikace služby Active Directory.

InvalidOperationException

Metoda ChangePassword(String, String, String) je volána před ActiveDirectoryMembershipProvider inicializaci instance.

Exception

Došlo k neošetřené výjimce.

Poznámky

Metoda ChangePassword se používá k aktualizaci hesla uživatele v úložišti dat služby Active Directory. Bez ohledu na přihlašovací údaje, které ActiveDirectoryMembershipProvider je instance nakonfigurovaná pro použití, se zprostředkovatel připojí k serveru služby Active Directory pomocí username parametrů a oldPassword jako přihlašovacích údajů pro připojení.

EnablePasswordReset Pokud je truevlastnost , uživatel nemůže změnit heslo, pokud byl účet dříve uzamčen, protože uživatel provedl příliš mnoho pokusů o odpověď na otázku hesla. Uživatel bude muset před změnou hesla počkat v minutách PasswordAnswerAttemptLockoutDuration zadaných ve vlastnosti .

Pokud je změna hesla úspěšná a EnablePasswordReset vlastnost je true, pak se čítače sledování odpovědí na chybné heslo uživatele resetují.

Zprostředkovatel vyhledá instanci uživatele, která se má aktualizovat, vyhledáním uživatelského jména v podstromu počínaje vyhledávacím bodem zadaným v připojovacím řetězci. Další informace o připojovacích řetězcích najdete v ActiveDirectoryMembershipProvider tématu třídy.

Pokud chcete změnit hesla na serveru Active Directory, connectionProtection musí být atribut nastavený na SignAndSealhodnotu .

Při použití serveru ADAM lze atribut nastavit na None, ale pouze v případě, že server ADAM explicitně nakonfigurujete tak, connectionProtection aby umožňoval změnu hesla přes nezabezpečená připojení.

Viz také

• Úvod do ASP.NET členství