SslStream.BeginAuthenticateAsClient メソッド

定義

名前空間:: System.Net.Security

アセンブリ:: netstandard.dll, System.Net.Security.dll

アセンブリ:: System.Net.Security.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

クライアントとサーバーの接続のクライアント側を認証する操作を開始します。

オーバーロード

名前	説明
BeginAuthenticateAsClient(String, AsyncCallback, Object)	サーバーを認証するための非同期操作を開始するためにクライアントによって呼び出され、必要に応じてクライアントが呼び出されます。
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)	サーバーを認証するための非同期操作を開始するためにクライアントによって呼び出され、必要に応じて、指定された証明書とシステムの既定のセキュリティプロトコルを使用してクライアントが呼び出されます。
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)	サーバーを認証するための非同期操作を開始するためにクライアントによって呼び出され、必要に応じて、指定された証明書とセキュリティプロトコルを使用してクライアントが呼び出されます。

注釈

認証の進行中は、このメソッドのオーバーロードはブロックされません。認証の完了を待機している間にブロックするには、 AuthenticateAsClient のいずれかの方法を使用します。

BeginAuthenticateAsClient(String, AsyncCallback, Object)

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

サーバーを認証するための非同期操作を開始するためにクライアントによって呼び出され、必要に応じてクライアントが呼び出されます。

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, AsyncCallback? asyncCallback, object? asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, AsyncCallback asyncCallback, object asyncState);

abstract member BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

パラメーター

targetHost: String

この SslStreamを共有するサーバーの名前。

asyncCallback: AsyncCallback

認証が完了したときに呼び出すメソッドを参照する AsyncCallback デリゲート。

asyncState: Object

操作に関する情報を含むユーザー定義オブジェクト。このオブジェクトは、操作の完了時に asyncCallback デリゲートに渡されます。

返品

IAsyncResult

非同期操作の状態を示す IAsyncResult オブジェクト。

例外

ArgumentNullException

targetHost は nullです。

AuthenticationException

認証に失敗し、このオブジェクトは使用できない状態のままです。

InvalidOperationException

認証は既に行われました。

-又は-

この SslStream を使用したサーバー認証は、以前に試行されました。

-又は-

認証は既に進行中です。

ObjectDisposedException

このオブジェクトは閉じられています。

注釈

.NET Framework 4.7 以降では、このメソッドは None を使用して認証を行います。これにより、オペレーティングシステムは、使用する最適なプロトコルを選択し、セキュリティで保護されていないプロトコルをブロックできます。 .NET Framework 4.6 (および最新のセキュリティパッチがインストールされている .NET Framework 4.5) では、許可される TLS/SSL プロトコルのバージョンは 1.2、1.1、および 1.0 です (Windows レジストリを編集して強力な暗号化を無効にしない限り)。認証ではクライアント証明書は使用されません。認証中に証明書失効リストがチェックされません。

targetHostに指定する値は、サーバーの証明書の名前と一致する必要があります。

EndAuthenticateAsClient メソッドを呼び出して、非同期認証操作を完了する必要があります。通常、メソッドは asyncCallback デリゲートによって呼び出されます。

このメソッドは、操作の完了中はブロックしません。操作が完了するまでブロックするには、 AuthenticateAsClient メソッドのオーバーロードのいずれかを使用します。

非同期プログラミングモデルの使用の詳細については、「非同期メソッドの呼び出し」を参照してください。

AuthenticationExceptionを受け取った場合、このSslStreamは使用できなくなります。ガベージコレクターが収集できるように、このオブジェクトを閉じて、そのオブジェクトへの参照をすべて削除する必要があります。

適用対象

BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

サーバーを認証するための非同期操作を開始するためにクライアントによって呼び出され、必要に応じて、指定された証明書とシステムの既定のセキュリティプロトコルを使用してクライアントが呼び出されます。

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);

abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

パラメーター

targetHost: String

この SslStreamを共有するサーバーの名前。

clientCertificates: X509CertificateCollection

クライアント証明書を含む X509CertificateCollection 。

checkCertificateRevocation: Boolean

認証時に証明書失効リストをチェックするかどうかを指定する Boolean 値。

asyncCallback: AsyncCallback

認証が完了したときに呼び出すメソッドを参照する AsyncCallback デリゲート。

asyncState: Object

操作に関する情報を含むユーザー定義オブジェクト。このオブジェクトは、操作の完了時に asyncCallback デリゲートに渡されます。

返品

IAsyncResult

非同期操作の状態を示す IAsyncResult オブジェクト。

例外

ArgumentNullException

targetHost は nullです。

AuthenticationException

認証に失敗し、このオブジェクトは使用できない状態のままです。

InvalidOperationException

認証は既に行われました。

-又は-

この SslStream を使用したサーバー認証は、以前に試行されました。

-又は-

認証は既に進行中です。

ObjectDisposedException

このオブジェクトは閉じられています。

注釈

targetHostに指定する値は、サーバーの証明書の名前と一致する必要があります。

非同期プログラミングモデルの使用の詳細については、「非同期メソッドの呼び出し」を参照してください。

Note

クライアント証明書は、SSL バージョン 2 プロトコルではサポートされていません。

適用対象

BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

サーバーを認証するための非同期操作を開始するためにクライアントによって呼び出され、必要に応じて、指定された証明書とセキュリティプロトコルを使用してクライアントが呼び出されます。

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);

abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult