StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
啟動非同步作業，以升級連接的通訊端，以在 StreamSocket 物件上使用 SSL。
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參數
- protectionLevel
- SocketProtectionLevel
代表 StreamSocket 物件上完整性和加密的保護層級。
- validationHostName
- HostName
升級至 SSL 時，用於驗證的遠端網路目的地主機名稱。
傳回
升級為在 StreamSocket 物件上使用 SSL 的非同步作業。
- 屬性
Windows 需求
| 應用程式功能 |
ID_CAP_NETWORKING [Windows Phone]
|
備註
UpgradeToSslAsync 方法只能用來升級與PlainSocketSocketProtectionLevel建立的已建立連線。
建立 SSL 連線的作業一般順序如下：
- 建立 StreamSocket。
- 使用Control屬性取得StreamSocketControl物件上的通訊端控制項資料，並在呼叫其中一個ConnectAsync方法之前設定任何屬性。
- 呼叫其中一個 ConnectAsync 方法，以建立與遠端端點的連線。 如果立即需要 SSL/TLS 連線，可以使用一些 ConnectAsync 方法來指定。 如果在傳送和接收一些初始資料之後需要 SSL/TLS 連線，則稍後可以呼叫 UpgradeToSslAsync 方法，以升級連線以使用 SSL。
- 取得 OutputStream 屬性，以將資料寫入遠端主機。
- 取得 InputStream 屬性，以從遠端主機讀取資料。
- 視需要讀取和寫入資料。
- 呼叫 Close 方法來中止任何擱置中的作業，並釋放與 StreamSocket 物件相關聯的所有 Unmanaged 資源。 UpgradeToSslAsync 方法需要建立連線的遠端伺服器能夠將 TCP 連線升級至 SSL 連線。
UpgradeToSslAsync 方法只能用於用戶端連線。 這個方法無法用來將 StreamSocketListener 所接受的連接升級為 SSL 連線。 UpgradeToSslAsync 方法只會實作 SSL 通訊協定交涉的用戶端元件，而不是接聽和接受 SSL 連線所需的伺服器元件。