StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) Metodo
Definizione
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.
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 IAsyncActionParametri
- 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
Operazione asincrona da aggiornare per l'uso di SSL in un oggetto StreamSocket .
- Attributi
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.