StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) 方法

定義

命名空間:

Windows.Networking.Sockets

啟動非同步作業，以升級連接的通訊端，以在 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 時，用於驗證的遠端網路目的地主機名稱。

傳回

IAsyncAction

升級為在 StreamSocket 物件上使用 SSL 的非同步作業。

屬性

RemoteAsyncAttribute

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 連線所需的伺服器元件。

另請參閱

• HostName
• SocketProtectionLevel
• 如何使用 TLS/SSL 保護通訊端連線