Language

StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) メソッド

定義

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 を使用するようにアップグレードする非同期操作。

属性

注釈

UpgradeToSslAsync メソッドは、PlainSocket の SocketProtectionLevel で確立されている接続をアップグレードする場合にのみ使用できます。

SSL 接続を確立する操作の一般的な順序は次のとおりです。

  • StreamSocket を作成します。
  • いずれかの ConnectAsync メソッドを呼び出す前に、Control プロパティを使用して StreamSocketControl オブジェクトのソケット コントロール データを取得し、プロパティを設定します。
  • ConnectAsync メソッドのいずれかを呼び出して、リモート エンドポイントとの接続を確立します。 SSL/TLS 接続がすぐに必要な場合は、一部の ConnectAsync メソッドを使用してこれを指定できます。 初期データの送受信後に SSL/TLS 接続が必要な場合は、後で UpgradeToSslAsync メソッドを呼び出して、SSL を使用するように接続をアップグレードできます。
  • リモート ホストにデータを書き込む OutputStream プロパティを取得します。
  • リモート ホストからデータを読み取る InputStream プロパティを取得します。
  • 必要に応じて、データの読み取りと書き込みを行います。
  • 保留中の操作を中止し、StreamSocket オブジェクトに関連付けられているすべてのアンマネージ リソースを解放するには、Close メソッドを呼び出します。 UpgradeToSslAsync メソッドでは、接続が確立されたリモート サーバーが TCP 接続を SSL 接続にアップグレードできる必要があります。

UpgradeToSslAsync メソッドは、クライアント接続にのみ使用できます。 このメソッドを使用して、 StreamSocketListener によって受け入れられた接続を SSL 接続にアップグレードすることはできません。 UpgradeToSslAsync メソッドは、SSL プロトコル ネゴシエーションのクライアント部分のみを実装します。SSL 接続のリッスンと受け入れに必要なサーバー部分は実装しません。

適用対象

関連項目