Partager via


StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) Méthode

Définition

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 IAsyncAction

Paramè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.

S’applique à

Voir aussi