StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Startet einen asynchronen Vorgang zum Upgrade eines verbundenen Sockets, um SSL für ein StreamSocket -Objekt zu verwenden.
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 IAsyncActionParameter
- protectionLevel
- SocketProtectionLevel
Die Schutzebene, die die Integrität und Verschlüsselung des StreamSocket-Objekts darstellt.
- validationHostName
- HostName
Der Hostname des Remotenetzwerkziels, das beim Upgrade auf SSL zur Überprüfung verwendet wird.
Gibt zurück
Ein asynchroner Vorgang zum Upgrade auf die Verwendung von SSL für ein StreamSocket-Objekt .
- Attribute
Hinweise
Die UpgradeToSslAsync-Methode kann nur verwendet werden, um eine bereits hergestellte Verbindung mit einem SocketProtectionLevel von PlainSocket zu aktualisieren.
Die typische Reihenfolge der Vorgänge zum Herstellen einer SSL-Verbindung lautet wie folgt:
- Erstellen Sie das StreamSocket.
- Rufen Sie Socketsteuerelementdaten für ein StreamSocketControl-Objekt mithilfe der Control-Eigenschaft ab, und legen Sie alle Eigenschaften fest, bevor Sie eine der ConnectAsync-Methoden aufrufen.
- Rufen Sie eine der ConnectAsync-Methoden auf, um eine Verbindung mit dem Remoteendpunkt herzustellen. Wenn sofort eine SSL/TLS-Verbindung erforderlich ist, kann dies mithilfe einiger ConnectAsync-Methoden angegeben werden. Wenn eine SSL/TLS-Verbindung nach dem Senden und Empfangen einiger Anfangsdaten gewünscht wird, kann die UpgradeToSslAsync-Methode später aufgerufen werden, um die Verbindung auf die Verwendung von SSL zu aktualisieren.
- Rufen Sie die OutputStream-Eigenschaft ab, um Daten auf den Remotehost zu schreiben.
- Rufen Sie die InputStream-Eigenschaft ab, um Daten vom Remotehost zu lesen.
- Daten nach Bedarf lesen und schreiben.
- Rufen Sie die Close-Methode auf, um alle ausstehenden Vorgänge abzubrechen und alle nicht verwalteten Ressourcen freizugeben, die dem StreamSocket-Objekt zugeordnet sind. Die UpgradeToSslAsync-Methode erfordert, dass der Remoteserver, mit dem die Verbindung hergestellt wurde, eine TCP-Verbindung auf eine SSL-Verbindung aktualisieren kann.
Die UpgradeToSslAsync-Methode kann nur für Clientverbindungen verwendet werden. Diese Methode kann nicht verwendet werden, um eine vom StreamSocketListener akzeptierte Verbindung auf eine SSL-Verbindung zu aktualisieren. Die UpgradeToSslAsync-Methode implementiert nur die Clientteile der SSL-Protokollverhandlung, nicht die Serverteile, die zum Überwachen und Akzeptieren von SSL-Verbindungen erforderlich wären.