次の方法で共有


ActiveDirectoryMembershipProvider.ChangePassword メソッド

定義

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

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

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

戻り値

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

例外

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

- または -

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

- または -

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

- または -

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

- または -

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

- または -

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

- または -

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

- または -

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

usernamenullです。

または

oldPasswordnullです。

または

newPasswordnullです。

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

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

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

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

注釈

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

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

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

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

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

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

適用対象

こちらもご覧ください