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 Aktualisieren eines verbundenen Sockets zur Verwendung von SSL für ein StreamSocket-Objekt .
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 für das StreamSocket-Objekt darstellt.
- validationHostName
- HostName
Der Hostname des Remotenetzwerkziels, das für die Überprüfung beim Upgrade auf SSL verwendet wird.
Gibt zurück
Ein asynchroner Vorgang zum Upgrade zur Verwendung von SSL für ein StreamSocket-Objekt .
- Attribute
Windows-Anforderungen
| App-Funktionen |
ID_CAP_NETWORKING [Windows Phone]
|
Hinweise
Die UpgradeToSslAsync-Methode kann nur verwendet werden, um ein Upgrade einer bereits hergestellten Verbindung mit einem SocketProtectionLevel von PlainSocket herzustellen.
Die typische Reihenfolge der Vorgänge zum Herstellen einer SSL-Verbindung lautet wie folgt:
- Erstellen Sie streamSocket.
- Rufen Sie Socketsteuerungsdaten 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 der ConnectAsync-Methoden angegeben werden. Wenn nach dem Senden und Empfangen einiger Anfangsdaten eine SSL/TLS-Verbindung 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.
- Lesen und Schreiben von Daten nach Bedarf.
- 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-Protokollaushandlung, nicht die Serverteile, die zum Lauschen und Akzeptieren von SSL-Verbindungen erforderlich wären.