StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Démarre une opération asynchrone pour mettre à niveau un socket connecté afin d’utiliser SSL sur un objet 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 IAsyncActionParamètres
- protectionLevel
- SocketProtectionLevel
Niveau de protection qui représente l’intégrité et le chiffrement sur l’objet StreamSocket .
- validationHostName
- HostName
Nom d’hôte de la destination réseau distante utilisée pour la validation lors de la mise à niveau vers SSL.
Retours
Opération asynchrone à mettre à niveau pour utiliser SSL sur un objet StreamSocket .
- Attributs
Configuration requise pour Windows
| Fonctionnalités de l’application |
ID_CAP_NETWORKING [Windows Phone]
|
Remarques
La méthode UpgradeToSslAsync ne peut être utilisée que pour mettre à niveau une connexion déjà établie établie avec un SocketProtectionLevel de PlainSocket.
L’ordre classique des opérations pour établir une connexion SSL est le suivant :
- Créez streamSocket.
- Obtenez les données de contrôle de socket sur un objet StreamSocketControl à l’aide de la propriété Control et définissez les propriétés avant d’appeler l’une des méthodes ConnectAsync .
- Appelez l’une des méthodes ConnectAsync pour établir une connexion avec le point de terminaison distant. Si une connexion SSL/TLS est requise immédiatement, cela peut être spécifié à l’aide de certaines des méthodes ConnectAsync . Si une connexion SSL/TLS est souhaitée après l’envoi et la réception de certaines données initiales, la méthode UpgradeToSslAsync peut être appelée ultérieurement pour mettre à niveau la connexion afin d’utiliser SSL.
- Obtenez la propriété OutputStream pour écrire des données sur l’hôte distant.
- Obtenez la propriété InputStream pour lire les données de l’hôte distant.
- Lire et écrire des données en fonction des besoins.
- Appelez la méthode Close pour abandonner toutes les opérations en attente et libérer toutes les ressources non managées associées à l’objet StreamSocket . La méthode UpgradeToSslAsync nécessite que le serveur distant sur lequel la connexion a été établie soit en mesure de mettre à niveau une connexion TCP vers une connexion SSL.
La méthode UpgradeToSslAsync ne peut être utilisée que pour les connexions clientes. Cette méthode ne peut pas être utilisée pour mettre à niveau une connexion acceptée par StreamSocketListener vers une connexion SSL. La méthode UpgradeToSslAsync implémente uniquement les parties clientes de la négociation du protocole SSL, et non les parties serveur nécessaires pour écouter et accepter les connexions SSL.