Поделиться через

StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) Метод

  • Ссылка

Определение

Пространство имен:
Windows.Networking.Sockets
Изменить

Запускает асинхронную операцию для обновления подключенного сокета для использования SSL в объекте StreamSocket .

public:
 virtual IAsyncAction ^ UpgradeToSslAsync(SocketProtectionLevel protectionLevel, HostName ^ validationHostName) = UpgradeToSslAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction UpgradeToSslAsync(SocketProtectionLevel const& protectionLevel, HostName const& validationHostName);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction UpgradeToSslAsync(SocketProtectionLevel protectionLevel, HostName validationHostName);
function upgradeToSslAsync(protectionLevel, validationHostName)
Public Function UpgradeToSslAsync (protectionLevel As SocketProtectionLevel, validationHostName As HostName) As IAsyncAction

Параметры

protectionLevel
SocketProtectionLevel

Уровень защиты, представляющий целостность и шифрование объекта StreamSocket .

validationHostName
HostName

Имя узла удаленного сетевого назначения, которое используется для проверки при обновлении до SSL.

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

IAsyncAction

Асинхронная операция обновления для использования SSL в объекте StreamSocket .

Атрибуты
RemoteAsyncAttribute

Требования к Windows

Возможности приложения
ID_CAP_NETWORKING [Windows Phone]

Комментарии

Метод UpgradeToSslAsync можно использовать только для обновления уже установленного подключения, созданного с помощью SocketProtectionLevelPlainSocket.

Типичный порядок операций по установке SSL-подключения выглядит следующим образом:

  • Создайте StreamSocket.
  • Получите данные элемента управления сокета в объекте StreamSocketControl с помощью свойства Control и задайте любые свойства перед вызовом одного из методов ConnectAsync .
  • Вызовите один из методов ConnectAsync , чтобы установить подключение к удаленной конечной точке. Если подключение SSL/TLS требуется немедленно, это можно указать с помощью некоторых методов ConnectAsync . Если после отправки и получения некоторых исходных данных требуется подключение SSL/TLS, метод UpgradeToSslAsync можно вызвать позже, чтобы обновить подключение для использования SSL.
  • Получение свойства OutputStream для записи данных на удаленный узел.
  • Получение свойства InputStream для чтения данных с удаленного узла.
  • При необходимости считывайте и записывайте данные.
  • Вызовите метод Close , чтобы прервать все ожидающие операции и освободить все неуправляемые ресурсы, связанные с объектом StreamSocket . Метод UpgradeToSslAsync требует, чтобы удаленный сервер, к которому установлено подключение, мог обновить TCP-подключение до SSL-подключения.

Метод UpgradeToSslAsync можно использовать только для клиентских подключений. Этот метод нельзя использовать для обновления подключения, принятого StreamSocketListener , до SSL-подключения. Метод UpgradeToSslAsync реализует только клиентские части согласования протокола SSL, а не серверные части, необходимые для прослушивания и приема SSL-подключений.

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

См. также раздел