ActiveDirectoryMembershipProvider.ChangePassword メソッド

定義

名前空間:

System.Web.Security

アセンブリ:

System.Web.dll

指定したユーザーのパスワードを変更します。

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

パラメーター

username

String

パスワードを更新するユーザーの名前。

oldPassword

String

指定したユーザーの現在のパスワード。

newPassword

String

指定したユーザーの新しいパスワード。

戻り値

Boolean

パスワードが正常に更新された場合は true。それ以外の場合は false。

例外

ArgumentException

username が空であるか、ユーザー名の最大長 (通常は 256 文字) を超えています。

- または -

username はコンマを含んでいます。

- または -

ユーザー名は userPrincipalName 属性にマップされており、username パラメーターに円記号が含まれています。

- または -

oldPassword または newPassword が長さ 0 の文字列です。

- または -

oldPassword または newPassword がパスワードの最大長 (通常は 128 文字) を超えています。

- または -

newPassword が、MinRequiredPasswordLength プロパティに指定されたパスワードの最小サイズに達していません。

- または -

newPassword に含まれるアルファベット以外の文字数が、MinRequiredNonAlphanumericCharacters プロパティに指定された数を下回っています。

- または -

newPassword が PasswordStrengthRegularExpression プロパティで定義されている正規表現による評価で不合格になりました。

ArgumentNullException

username が nullです。

または

oldPassword は null です。

または

newPassword が nullです。

MembershipPasswordException

newPassword が Active Directory サーバーで定義されている複雑さの要件を満たしていません。

ProviderException

Active Directory Application Mode サーバーへのセキュリティで保護された接続を確立できませんでした。

InvalidOperationException

ChangePassword(String, String, String) インスタンスが初期化される前に ActiveDirectoryMembershipProvider メソッドが呼び出されました。

Exception

ハンドルされていない例外が発生しました。

注釈

メソッドは ChangePassword 、Active Directory データ ストア内のユーザーのパスワードを更新するために使用されます。 インスタンスが使用するように構成されている資格情報ActiveDirectoryMembershipProviderに関係なく、プロバイダーは、 パラメーターと oldPassword パラメーターを接続資格情報として使用して username Active Directory サーバーに接続します。

プロパティが EnablePasswordReset の場合、ユーザーが trueパスワードの質問に答えようとした回数が多すぎるため、アカウントが以前にロックされていた場合、ユーザーはパスワードを変更できません。 ユーザーは、パスワードを変更する前に、 プロパティで PasswordAnswerAttemptLockoutDuration 指定された分数を待つ必要があります。

パスワードの変更が成功し、 EnablePasswordReset プロパティが の場合、 trueユーザーの無効なパスワード応答追跡カウンターがリセットされます。

プロバイダーは、接続文字列で指定された検索ポイントから始まるユーザー名のサブツリー検索を実行して、更新するユーザー インスタンスを検索します。 接続文字列の ActiveDirectoryMembershipProvider 詳細については、クラスのトピックを参照してください。

Active Directory サーバーでパスワードを変更するには、属性を connectionProtection に設定する SignAndSeal必要があります。

ADAM サーバーを使用する場合は、 属性を connectionProtection に None設定できますが、セキュリティで保護されていない接続でのパスワード変更を許可するように ADAM サーバーを明示的に構成した場合に限ります。

こちらもご覧ください

• ASP.NET メンバーシップの概要