AuthenticationService.ValidateUser(String, String, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーの資格情報を認証しますが、認証チケットは作成しません。
public:
bool ValidateUser(System::String ^ username, System::String ^ password, System::String ^ customCredential);
[System.ServiceModel.OperationContract]
public bool ValidateUser (string username, string password, string customCredential);
[<System.ServiceModel.OperationContract>]
member this.ValidateUser : string * string * string -> bool
Public Function ValidateUser (username As String, password As String, customCredential As String) As Boolean
パラメーター
- username
- String
妥当性を確認するユーザー名。
- password
- String
指定したユーザーのパスワード。
- customCredential
- String
username
と password
以外にも妥当性を確認する値があればその値。
戻り値
資格情報が有効な場合は true
。それ以外の場合は false
。
- 属性
例外
userName
または password
が null
です。
注釈
メソッドは ValidateUser ユーザーの資格情報を認証しますが、認証 Cookie は設定しません。 認証 Cookie がない場合、資格情報が有効であっても、ユーザーはログインされません。
認証 Cookie を ValidateUser 受け取らずにユーザーの資格情報が有効かどうかを確認する必要がある場合は、 メソッドを使用します。 たとえば、認証 Cookie がクライアント アプリケーションに既に格納されているが、新しいセッションの開始時にユーザーの資格情報がまだ有効であることを確認する場合に、これを行うことができます。
メソッドは ValidateUser イベントを Authenticating 発生させますが、イベントは CreatingCookie 発生しません。
注意
Web サーバーで ValidateUser 実行されているコードから メソッドを呼び出さないでください。 メソッドは、 ValidateUser WCF サービスの一部としてのみ呼び出します。 詳細については、「 ASP.NET 認証」を参照してください。
適用対象
こちらもご覧ください
.NET