ActiveDirectoryMembershipProvider.ChangePassword メソッド

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

ActiveDirectoryMembershipProvider.ChangePassword メソッド

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

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

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

Visual Basic (宣言)

Public Overrides Function
 ChangePassword ( _
    username As String, _
    oldPassword As String, _
    newPassword As String _
) As Boolean

Visual Basic (使用法)

Dim instance As ActiveDirectoryMembershipProvider
Dim username As String
Dim oldPassword As String
Dim newPassword As String
Dim returnValue As Boolean

returnValue = instance.ChangePassword(username, oldPassword, newPassword)

C#

public override bool ChangePassword (
    string username,
    string oldPassword,
    string newPassword
)

C++

public:
virtual bool ChangePassword (
    String^ username, 
    String^ oldPassword, 
    String^ newPassword
) override

J#

public boolean ChangePassword (
    String username, 
    String oldPassword, 
    String newPassword
)

JScript

public override function ChangePassword (
    username : String, 
    oldPassword : String, 
    newPassword : String
) : boolean

パラメータ

username

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

oldPassword

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

newPassword

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

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

例外

例外の種類	条件
ArgumentException	username が空であるか、ユーザー名の最大長 (通常は 256 文字) を超えています。 または username はコンマを含んでいます。 または ユーザー名は userPrincipalName 属性にマップされており、username パラメータに円記号が含まれています。 または oldPassword または newPassword が長さ 0 の文字列です。 または oldPassword または newPassword がパスワードの最大長 (通常は 128 文字) を超えています。 または newPassword が、MinRequiredPasswordLength プロパティに指定されたパスワードの最小サイズに達していません。 または newPassword に含まれるアルファベット以外の文字数が、MinRequiredNonAlphanumericCharacters プロパティに指定された数を下回っています。 または newPassword が PasswordStrengthRegularExpression プロパティで定義されている正規表現による評価で不合格になりました。
ArgumentNullException	username が null 参照 (Visual Basic では Nothing) です。 または oldPassword が null 参照 (Visual Basic では Nothing) です。 または newPassword が null 参照 (Visual Basic では Nothing) です。
MembershipPasswordException	newPassword が Active Directory サーバーで定義されている複雑さの要件を満たしていません。
ProviderException	Active Directory Application Mode サーバーへのセキュリティで保護された接続を確立できませんでした。
InvalidOperationException	ActiveDirectoryMembershipProvider インスタンスが初期化される前に ChangePassword メソッドが呼び出されました。

解説

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

EnablePasswordReset プロパティが true の場合、パスワードの質問への解答を所定の回数指定したことが原因でユーザーのアカウントが以前にロックされていたときは、ユーザーはパスワードを変更できません。ユーザーは、PasswordAnswerAttemptLockoutDuration プロパティに指定された時間 (分数) が経過するのを待ってから、パスワードを変更する必要があります。

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

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

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

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

プラットフォーム

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 名前空間
その他の技術情報
メンバシップの概要