StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Запускает асинхронную операцию для обновления подключенного сокета для использования 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.
Возвращаемое значение
Асинхронная операция обновления для использования SSL в объекте StreamSocket .
- Атрибуты
Требования к 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-подключений.