StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicia una operación asincrónica para actualizar un socket conectado para usar SSL en un objeto 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 IAsyncActionParámetros
- protectionLevel
- SocketProtectionLevel
Nivel de protección que representa la integridad y el cifrado en el objeto StreamSocket .
- validationHostName
- HostName
El nombre de host del destino de red remota que se usa para la validación al actualizar a SSL.
Devoluciones
Una operación asincrónica para actualizar para usar SSL en un objeto StreamSocket .
- Atributos
Requisitos de Windows
| Características de aplicaciones |
ID_CAP_NETWORKING [Windows Phone]
|
Comentarios
El método UpgradeToSslAsync solo se puede usar para actualizar una conexión ya establecida realizada con un SocketProtectionLevel de PlainSocket.
El orden típico de las operaciones para establecer una conexión SSL es el siguiente:
- Cree streamSocket.
- Obtenga datos de control de socket en un objeto StreamSocketControl mediante la propiedad Control y establezca las propiedades antes de llamar a uno de los métodos ConnectAsync .
- Llame a uno de los métodos ConnectAsync para establecer una conexión con el punto de conexión remoto. Si se requiere inmediatamente una conexión SSL/TLS, se puede especificar mediante algunos de los métodos ConnectAsync . Si se desea una conexión SSL/TLS después de enviar y recibir algunos datos iniciales, se puede llamar al método UpgradeToSslAsync más adelante para actualizar la conexión para usar SSL.
- Obtenga la propiedad OutputStream para escribir datos en el host remoto.
- Obtenga la propiedad InputStream para leer datos del host remoto.
- Leer y escribir datos según sea necesario.
- Llame al método Close para anular las operaciones pendientes y liberar todos los recursos no administrados asociados al objeto StreamSocket . El método UpgradeToSslAsync requiere que el servidor remoto al que se estableció la conexión pueda actualizar una conexión TCP a una conexión SSL.
El método UpgradeToSslAsync solo se puede usar para las conexiones de cliente. Este método no se puede usar para actualizar una conexión aceptada por StreamSocketListener a una conexión SSL. El método UpgradeToSslAsync solo implementa las partes de cliente de la negociación del protocolo SSL, no los elementos de servidor necesarios para escuchar y aceptar conexiones SSL.