SslStream.BeginAuthenticateAsServer Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Начинает асинхронную операцию для проверки подлинности серверной стороны соединения клиент-сервер.
Перегрузки
| BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object) |
Вызывается серверами для начала асинхронной операции проверки подлинности клиента, и, при необходимости, сервера в соединении клиент-сервер. |
| BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object) |
Вызывается серверами для запуска асинхронной операции проверки подлинности сервера и (при необходимости) клиента с использованием указанных сертификатов, требований и протокола безопасности системы по умолчанию. |
| BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object) |
Вызывается серверами для запуска асинхронной операции проверки подлинности сервера и (при необходимости) клиента с использованием указанных сертификатов, требований и протокола безопасности. |
Комментарии
Перегрузки этого метода не блокируются во время проверки подлинности. Чтобы выполнить блокировку во время ожидания завершения проверки подлинности, используйте один из AuthenticateAsServer методов.
BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
Вызывается серверами для начала асинхронной операции проверки подлинности клиента, и, при необходимости, сервера в соединении клиент-сервер.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultПараметры
- serverCertificate
- X509Certificate
Сертификат X509, который используется для проверки подлинности сервера.
- asyncCallback
- AsyncCallback
Делегат AsyncCallback , который ссылается на метод, вызываемый после выполнения проверки подлинности.
- asyncState
- Object
Пользовательский объект, содержащий сведения об операции. Этот объект передается делегату asyncCallback после завершения операции.
Возвращаемое значение
Объект IAsyncResult, указывающий состояние асинхронной операции.
Исключения
serverCertificate имеет значение null.
Произошел сбой проверки подлинности, и этот объект остался в неработоспособном состоянии.
Проверка подлинности уже выполнена.
-или-
Попытка проверки подлинности клиента с помощью этого параметра SslStream уже выполнена ранее.
-или-
Проверка подлинности уже выполняется.
Объект закрыт.
Метод BeginAuthenticateAsServer не поддерживается в Windows 95, Windows 98 и Windows Millennium.
Комментарии
Начиная с версии .NET Framework 4.7 этот метод выполняет проверку подлинности с помощью None, что позволяет операционной системе выбрать наилучший протокол для использования и блокирования протоколов, которые не являются безопасными. В .NET Framework 4.6 (и .NET Framework 4.5 с последними обновлениями безопасности) допустимы версии протокола TLS/SSL 1.0, 1.1 и 1.2 (если только вы не отключите надежное шифрование в реестре Windows). Список отзыва сертификатов не проверяется во время проверки подлинности. Клиенту не требуется предоставлять сертификат для проверки подлинности.
Асинхронная операция проверки подлинности должна быть завершена путем вызова EndAuthenticateAsClient метода . Как правило, метод вызывается делегатом asyncCallback .
Этот метод не блокируется во время завершения операции. Чтобы заблокировать до завершения операции, используйте одну из AuthenticateAsClient перегрузок метода.
Подробные сведения об использовании асинхронной модели программирования см. в разделе Асинхронный вызов синхронных методов.
Если вы получаете AuthenticationException, этот SslStream объект больше не будет использоваться. Этот объект следует закрыть и удалить все ссылки на него, чтобы сборщик мусора смог собрать его.
Применяется к
BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
Вызывается серверами для запуска асинхронной операции проверки подлинности сервера и (при необходимости) клиента с использованием указанных сертификатов, требований и протокола безопасности системы по умолчанию.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultПараметры
- serverCertificate
- X509Certificate
Сертификат X509, который используется для проверки подлинности сервера.
- clientCertificateRequired
- Boolean
Значение Boolean, которое указывает, получает ли клиент запрос на сертификат для проверки подлинности. Обратите внимание, что это — только запрос. Если сертификат не предоставляется, сервер продолжает принимать запрос на подключение.
- checkCertificateRevocation
- Boolean
Значение Boolean, которое указывает, проверяется ли список отзыва сертификатов при проверке подлинности.
- asyncCallback
- AsyncCallback
Делегат AsyncCallback, который ссылается на метод, вызываемый после выполнения проверки подлинности.
- asyncState
- Object
Пользовательский объект, содержащий сведения об операции. Этот объект передается делегату asyncCallback после завершения операции.
Возвращаемое значение
Объект IAsyncResult, представляющий состояние асинхронной операции.
Исключения
serverCertificate имеет значение null.
Произошел сбой проверки подлинности, и этот объект остался в неработоспособном состоянии.
Проверка подлинности уже выполнена.
-или-
Попытка проверки подлинности сервера с использованием SslStream уже выполнена.
-или-
Проверка подлинности уже выполняется.
Объект закрыт.
Метод BeginAuthenticateAsServer не поддерживается в Windows 95, Windows 98 и Windows Millennium.
Комментарии
Начиная с версии .NET Framework 4.7 этот метод выполняет проверку подлинности с помощью None, что позволяет операционной системе выбрать наилучший протокол для использования и блокирования протоколов, которые не являются безопасными. В .NET Framework 4.6 (и .NET Framework 4.5 с последними обновлениями безопасности) допустимы версии протокола TLS/SSL 1.0, 1.1 и 1.2 (если только вы не отключите надежное шифрование в реестре Windows).
Асинхронная операция проверки подлинности должна быть завершена путем вызова EndAuthenticateAsServer метода . Как правило, метод вызывается делегатом asyncCallback .
Этот метод не блокируется во время завершения операции. Чтобы заблокировать до завершения операции, используйте одну из AuthenticateAsServer перегрузок метода.
Подробные сведения об использовании асинхронной модели программирования см. в разделе Асинхронный вызов синхронных методов.
Если вы получаете AuthenticationException, этот SslStream объект больше не будет использоваться. Этот объект следует закрыть и удалить все ссылки на него, чтобы сборщик мусора смог собрать его.
Применяется к
BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
Вызывается серверами для запуска асинхронной операции проверки подлинности сервера и (при необходимости) клиента с использованием указанных сертификатов, требований и протокола безопасности.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultПараметры
- serverCertificate
- X509Certificate
Сертификат X509, который используется для проверки подлинности сервера.
- clientCertificateRequired
- Boolean
Значение Boolean, которое указывает, получает ли клиент запрос на сертификат для проверки подлинности. Обратите внимание, что это — только запрос. Если сертификат не предоставляется, сервер продолжает принимать запрос на подключение.
- enabledSslProtocols
- SslProtocols
Значение SslProtocols, которое представляет протоколы, используемые для проверки подлинности.
- checkCertificateRevocation
- Boolean
Значение Boolean, которое указывает, проверяется ли список отзыва сертификатов при проверке подлинности.
- asyncCallback
- AsyncCallback
Делегат AsyncCallback, который ссылается на метод, вызываемый после выполнения проверки подлинности.
- asyncState
- Object
Пользовательский объект, содержащий сведения об операции. Этот объект передается делегату asyncCallback после завершения операции.
Возвращаемое значение
Объект IAsyncResult, представляющий состояние асинхронной операции.
Исключения
serverCertificate имеет значение null.
enabledSslProtocols не является допустимым значением SslProtocols.
Произошел сбой проверки подлинности, и этот объект остался в неработоспособном состоянии.
Проверка подлинности уже выполнена.
-или-
Попытка проверки подлинности сервера с использованием SslStream уже выполнена.
-или-
Проверка подлинности уже выполняется.
Объект закрыт.
Метод BeginAuthenticateAsServer не поддерживается в Windows 95, Windows 98 и Windows Millennium.
Комментарии
Начиная с версии .NET Framework 4.7 этот метод выполняет проверку подлинности с помощью None, что позволяет операционной системе выбрать наилучший протокол для использования и блокирования протоколов, которые не являются безопасными. В .NET Framework 4.6 (и .NET Framework 4.5 с последними обновлениями безопасности) допустимы версии протокола TLS/SSL 1.0, 1.1 и 1.2 (если только вы не отключите надежное шифрование в реестре Windows).
Асинхронная операция проверки подлинности должна быть завершена путем вызова EndAuthenticateAsServer метода . Как правило, метод вызывается делегатом asyncCallback .
Этот метод не блокируется во время завершения операции. Чтобы заблокировать до завершения операции, используйте одну из AuthenticateAsServer перегрузок метода.
Подробные сведения об использовании асинхронной модели программирования см. в разделе Асинхронный вызов синхронных методов.
Если вы получаете AuthenticationException, этот SslStream объект больше не будет использоваться. Этот объект следует закрыть и удалить все ссылки на него, чтобы сборщик мусора смог собрать его.
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по