StreamSocket.UpgradeToSslAsync(SocketProtectionLevel, HostName) Metode

Referensi

Definisi

Ruang nama:: Windows.Networking.Sockets

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Memulai operasi asinkron untuk meningkatkan soket yang terhubung untuk menggunakan SSL pada objek StreamSocket .

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

Parameter

protectionLevel: SocketProtectionLevel

Tingkat perlindungan yang mewakili integritas dan enkripsi pada objek StreamSocket .

validationHostName: HostName

Nama host tujuan jaringan jarak jauh yang digunakan untuk validasi saat memutakhirkan ke SSL.

Mengembalikan

IAsyncAction

Operasi asinkron yang akan ditingkatkan untuk menggunakan SSL pada objek StreamSocket .

Atribut: RemoteAsyncAttribute

Persyaratan Windows

Kemampuan aplikasi

ID_CAP_NETWORKING [Windows Phone]

Keterangan

Metode UpgradeToSslAsync hanya dapat digunakan untuk meningkatkan koneksi yang sudah dibuat yang dibuat dengan SocketProtectionLevel dari PlainSocket.

Urutan operasi umum untuk membuat koneksi SSL adalah sebagai berikut:

Buat StreamSocket.
Dapatkan data kontrol soket pada objek StreamSocketControl menggunakan properti Kontrol dan atur properti apa pun sebelum memanggil salah satu metode ConnectAsync .
Panggil salah satu metode ConnectAsync untuk membuat koneksi dengan titik akhir jarak jauh. Jika koneksi SSL/TLS diperlukan segera, ini dapat ditentukan menggunakan beberapa metode ConnectAsync . Jika koneksi SSL/TLS diinginkan setelah mengirim dan menerima beberapa data awal, maka metode UpgradeToSslAsync dapat dipanggil nanti untuk meningkatkan koneksi untuk menggunakan SSL.
Dapatkan properti OutputStream untuk menulis data ke host jarak jauh.
Dapatkan properti InputStream untuk membaca data dari host jarak jauh.
Membaca dan menulis data sesuai kebutuhan.
Panggil metode Tutup untuk membatalkan operasi yang tertunda dan melepaskan semua sumber daya yang tidak dikelola yang terkait dengan objek StreamSocket . Metode UpgradeToSslAsync mengharuskan server jarak jauh tempat koneksi dibuat dapat meningkatkan koneksi TCP ke koneksi SSL.

Metode UpgradeToSslAsync hanya dapat digunakan untuk koneksi klien. Metode ini tidak dapat digunakan untuk meningkatkan koneksi yang diterima oleh StreamSocketListener ke koneksi SSL. Metode UpgradeToSslAsync hanya mengimplementasikan bagian klien dari negosiasi protokol SSL, bukan bagian server yang akan diperlukan untuk mendengarkan dan menerima koneksi SSL.

Berlaku untuk