SslStream.BeginAuthenticateAsClient Метод

Определение

Пространство имен:: System.Net.Security

Сборки:: netstandard.dll, System.Net.Security.dll

Сборка:: System.Net.Security.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Начинает операцию проверки подлинности клиентской стороны подключения к клиентскому серверу.

Перегрузки

Имя	Описание
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

Возвращаемое значение

IAsyncResult

Объект IAsyncResult , указывающий состояние асинхронной операции.

Исключения

ArgumentNullException

targetHost равно null.

AuthenticationException

Сбой проверки подлинности и оставил этот объект в неиспользуемом состоянии.

InvalidOperationException

Проверка подлинности уже произошла.

–или–

Проверка подлинности сервера, используемая SslStream ранее.

–или–

Проверка подлинности уже выполняется.

ObjectDisposedException

Этот объект был закрыт.

Применяется к

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

Параметры

targetHost: String

Имя сервера, который использует этот SslStreamпараметр.

clientCertificates: X509CertificateCollection

Содержащие X509CertificateCollection сертификаты клиента.

enabledSslProtocols: SslProtocols

Значение SslProtocols , представляющее протоколы, используемые для проверки подлинности.

checkCertificateRevocation: Boolean

Значение Boolean , указывающее, проверяется ли список отзыва сертификата во время проверки подлинности.

asyncCallback: AsyncCallback

Делегат AsyncCallback , ссылающийся на метод для вызова при завершении проверки подлинности.

asyncState: Object

Возвращаемое значение

IAsyncResult

Объект IAsyncResult , указывающий состояние асинхронной операции.

Исключения

ArgumentNullException

targetHost равно null.

ArgumentException

enabledSslProtocols недопустимое SslProtocols значение.

AuthenticationException

Сбой проверки подлинности и оставил этот объект в неиспользуемом состоянии.

InvalidOperationException

Проверка подлинности уже произошла.

–или–

Проверка подлинности сервера, используемая SslStream ранее.

–или–

Проверка подлинности уже выполняется.

ObjectDisposedException

Этот объект был закрыт.

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

SslStream.BeginAuthenticateAsClient Метод

Определение

Перегрузки

Комментарии

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к

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

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к

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

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к