StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.Networking.Sockets

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Avvia un'operazione asincrona per aggiornare un socket connesso per usare SSL in un oggetto 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

Parametri

protectionLevel: SocketProtectionLevel

Livello di protezione che rappresenta l'integrità e la crittografia nell'oggetto StreamSocket .

validationHostName: HostName

Nome host della destinazione di rete remota usata per la convalida durante l'aggiornamento a SSL.

Restituisce

IAsyncAction

Operazione asincrona da aggiornare per l'uso di SSL in un oggetto StreamSocket .

Attributi: RemoteAsyncAttribute

Requisiti Windows

Funzionalità dell'app

ID_CAP_NETWORKING [Windows Phone]

Commenti

Il metodo UpgradeToSslAsync può essere usato solo per aggiornare una connessione già stabilita con SocketProtectionLevel di PlainSocket.

L'ordine tipico delle operazioni per stabilire una connessione SSL è il seguente:

Creare StreamSocket.
Ottenere i dati del controllo socket in un oggetto StreamSocketControl usando la proprietà Control e impostare le proprietà prima di chiamare uno dei metodi ConnectAsync .
Chiamare uno dei metodi ConnectAsync per stabilire una connessione con l'endpoint remoto. Se è necessaria immediatamente una connessione SSL/TLS, è possibile specificare questa opzione usando alcuni dei metodi ConnectAsync . Se si desidera una connessione SSL/TLS dopo l'invio e la ricezione di alcuni dati iniziali, il metodo UpgradeToSslAsync può essere chiamato in un secondo momento per aggiornare la connessione per l'uso di SSL.
Ottenere la proprietà OutputStream per scrivere dati nell'host remoto.
Ottenere la proprietà InputStream per leggere i dati dall'host remoto.
Leggere e scrivere i dati in base alle esigenze.
Chiamare il metodo Close per interrompere le operazioni in sospeso e rilasciare tutte le risorse non gestite associate all'oggetto StreamSocket . Il metodo UpgradeToSslAsync richiede che il server remoto a cui è stata stabilita la connessione sia in grado di aggiornare una connessione TCP a una connessione SSL.

Il metodo UpgradeToSslAsync può essere usato solo per le connessioni client. Questo metodo non può essere usato per aggiornare una connessione accettata da StreamSocketListener a una connessione SSL. Il metodo UpgradeToSslAsync implementa solo le parti client della negoziazione del protocollo SSL, non le parti del server necessarie per ascoltare e accettare le connessioni SSL.

Si applica a

Condividi tramite