Compartir a través de

StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) Método

  • Referencia

Definición

Espacio de nombres:
Windows.Networking.Sockets
Editar

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 IAsyncAction

Pará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

IAsyncAction

Una operación asincrónica para actualizar para usar SSL en un objeto StreamSocket .

Atributos
RemoteAsyncAttribute

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.

Se aplica a

Consulte también