ActiveDirectoryMembershipProvider.ResetPassword メソッド

.NET Framework クラス ライブラリ リファレンス

ActiveDirectoryMembershipProvider.ResetPassword メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザーのパスワードを、自動的に生成された新しいパスワードにリセットします。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 ResetPassword ( _
    username As String, _
    passwordAnswer As String _
) As String

Visual Basic (使用法)

Dim instance As ActiveDirectoryMembershipProvider
Dim username As String
Dim passwordAnswer As String
Dim returnValue As String

returnValue = instance.ResetPassword(username, passwordAnswer)

C#

public override string ResetPassword (
    string username,
    string passwordAnswer
)

C++

public:
virtual String^ ResetPassword (
    String^ username, 
    String^ passwordAnswer
) override

J#

public String ResetPassword (
    String username, 
    String passwordAnswer
)

JScript

public override function ResetPassword (
    username : String, 
    passwordAnswer : String
) : String

パラメータ

username

パスワードをリセットするユーザー。

passwordAnswer

指定したユーザーのパスワードの解答。

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

例外

例外の種類	条件
InvalidOperationException	ActiveDirectoryMembershipProvider インスタンスが初期化される前に ResetPassword メソッドが呼び出されました。
NotSupportedException	EnablePasswordReset プロパティ値が false です。
ArgumentNullException	passwordAnswer が null 参照 (Visual Basic では Nothing) です。 または username が null 参照 (Visual Basic では Nothing) です。
ArgumentException	トリム後の passwordAnswer が空です。 または passwordAnswer が 128 文字を超えています。 または username が空であるか、ユーザー名の許容最大長 (通常は 256 文字) を超えています。 または username はコンマを含んでいます。 または ユーザー名は userPrincipalName にマップされていますが、username パラメータに円記号が含まれています。
MembershipPasswordException	無効なログオン試行が所定の回数行われたか、またはパスワードの解答によるリセット試行が所定の回数行われたため、ユーザーがロックアウトされています。 または passwordAnswer は、格納されているパスワードの解答と一致しません。
ProviderException	username に指定されたユーザーが Active Directory データ ストアに存在しません。 または 生成されたパスワードがカスタム検証ハンドラに合格しませんでした。 または 生成されたパスワードが Active Directory サーバーで設定されているカスタム パスワード ポリシーの複雑さの基準を満たしていません。 または 新しいパスワードを設定するために Active Directory Application Mode サーバーにセキュリティで保護された接続を確立できません。

解説

このメソッドは、Active Directory データ ストアでユーザーのパスワードをランダムに生成された新しい値にリセットするときに、Membership クラスによって呼び出されます。新しいパスワードが返されます。

メモ
ResetPassword メソッドにより生成されたランダム パスワードは、PasswordStrengthRegularExpression プロパティの正規表現に合格するとは限りません。ただし、ランダム パスワードは、MinRequiredPasswordLength プロパティおよび MinRequiredNonAlphanumericCharacters プロパティで設定された基準は満たしています。

正しくないパスワードの解答が ResetPassword メソッドに対して入力されると、無効なパスワードの解答の指定回数を追跡する内部カウンタが 1 つインクリメントされます。これにより、UnlockUser メソッドが呼び出されてロック ステータスが解除されるまでそのユーザーのログオンを禁止できます。ユーザーがロックアウトされていない状態で、正しいパスワードの解答が指定されると、無効なパスワードの解答の指定回数を追跡する内部カウンタはゼロにリセットされます。詳細については、MaxInvalidPasswordAttempts プロパティのトピックと PasswordAttemptWindow プロパティのトピックを参照してください。

すべてのパラメータ値について先頭と末尾の空白はトリムされます。

最初に Membership.Provider プロパティから ActiveDirectoryMembershipProvider インスタンスの参照を取得することにより、ResetPassword メソッドを直接呼び出すことができます。

プロバイダは、接続文字列で指定された検索位置を開始点としてサブツリー検索を実行します。接続文字列の詳細については、ActiveDirectoryMembershipProvider クラスのトピックを参照してください。

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

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

メモ
Active Directory サーバーに設定されているセキュリティ ポリシーによっては、このポリシーを満たすパスワードを ResetPassword メソッドが生成できない場合があります。GeneratePassword メソッドの既定の実装では、Windows Server 2003 SP1 を実行しているドメイン コントローラの既定のパスワード ポリシーを満たすパスワードが生成されます。Active Directory サーバーのセキュリティ ポリシーが原因でパスワードをリセットできない場合は、ProviderException がスローされます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ActiveDirectoryMembershipProvider クラス
ActiveDirectoryMembershipProvider メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要