StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicia uma operação assíncrona para atualizar um soquete conectado para usar SSL em um 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
O nível de proteção que representa a integridade e a criptografia no objeto StreamSocket .
- validationHostName
- HostName
O nome do host do destino de rede remota usado para validação ao atualizar para SSL.
Retornos
Uma operação assíncrona a ser atualizada para usar o SSL em um objeto StreamSocket .
- Atributos
Requisitos do Windows
| Funcionalidades do aplicativo |
ID_CAP_NETWORKING [Windows Phone]
|
Comentários
O método UpgradeToSslAsync só pode ser usado para atualizar uma conexão já estabelecida feita com um SocketProtectionLevel de PlainSocket.
A ordem típica de operações para estabelecer uma conexão SSL é a seguinte:
- Crie o StreamSocket.
- Obtenha dados de controle de soquete em um objeto StreamSocketControl usando a propriedade Control e defina todas as propriedades antes de chamar um dos métodos ConnectAsync .
- Chame um dos métodos ConnectAsync para estabelecer uma conexão com o ponto de extremidade remoto. Se uma conexão SSL/TLS for necessária imediatamente, isso poderá ser especificado usando alguns dos métodos ConnectAsync . Se uma conexão SSL/TLS for desejada depois de enviar e receber alguns dados iniciais, o método UpgradeToSslAsync poderá ser chamado posteriormente para atualizar a conexão para usar SSL.
- Obtenha a propriedade OutputStream para gravar dados no host remoto.
- Obtenha a propriedade InputStream para ler dados do host remoto.
- Ler e gravar dados conforme necessário.
- Chame o método Close para anular todas as operações pendentes e liberar todos os recursos não gerenciados associados ao objeto StreamSocket . O método UpgradeToSslAsync requer que o servidor remoto ao qual a conexão foi estabelecida seja capaz de atualizar uma conexão TCP para uma conexão SSL.
O método UpgradeToSslAsync só pode ser usado para conexões de cliente. Esse método não pode ser usado para atualizar uma conexão aceita pelo StreamSocketListener para uma conexão SSL. O método UpgradeToSslAsync implementa apenas as partes do cliente da negociação de protocolo SSL, não as partes do servidor que seriam necessárias para escutar e aceitar conexões SSL.