Bagikan melalui

IRDPSRAPIViewer::Metode connect (rdpencomapi.h)

  • Artikel

[Antarmuka IRDPSRAPIViewer tidak lagi tersedia untuk digunakan untuk aplikasi UWP pada Windows 10, versi 1709. Ini masih didukung untuk aplikasi Desktop.]

Memulai koneksi aktual ke sharer.

Sintaks

HRESULT Connect(
  [in] BSTR bstrConnectionString,
  [in] BSTR bstrName,
  [in] BSTR bstrPassword
);

Parameter

[in] bstrConnectionString

Jenis: BSTR

string koneksi digunakan untuk menyambungkan ke sharer dan mengautentikasi penampil.

[in] bstrName

Jenis: BSTR

Nama untuk penampil. Nama dikirim ke sharer dan pemirsa lainnya. String dibatasi hingga 255 karakter.

[in] bstrPassword

Jenis: BSTR

Kata sandi yang digunakan untuk autentikasi. Kata sandi dikirim di luar band dari sharer.

Nilai kembali

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan S_OK. Jika tidak, nilai yang dikembalikan adalah kode kesalahan.

Keterangan

String koneksi yang terkandung dalam parameter bstrConnectionString dihasilkan oleh sharer dan diperoleh oleh penampil dengan menyelesaikan langkah-langkah berikut:

  1. Sharer mendapatkan instans antarmuka IRDPSRAPIInvitationManager dari properti IRDPSRAPISharingSession::Invitations .
  2. Sharer mendapatkan instans antarmuka IRDPSRAPIInvitation dengan memanggil metode IRDPSRAPIInvitationManager::CreateInvitation .
  3. Sharer memperoleh string koneksi dari properti IRDPSRAPIInvitation::ConnectionString.
  4. Sharer mengirimkan string koneksi ke penampil dalam metode yang ditentukan aplikasi, seperti menyimpan string koneksi dalam file dan berbagi file dengan penampil.
Untuk peningkatan keamanan, aplikasi dapat mengaitkan kata sandi dengan undangan di sisi sharer. Kata sandi tersebut biasanya didistribusikan kepada pemirsa melalui beberapa mekanisme selain yang digunakan untuk mengirim string koneksi. Hal ini untuk mencegah jenis serangan "sniffing" jaringan. Jika undangan memiliki kata sandi yang terkait dengannya, kata sandi harus diteruskan melalui API ini. Jika tidak, peserta akan terputus.

String bstrName yang diatur dalam properti ini dikirim ke sharer setelah koneksi dimulai. Properti adalah nama yang mudah diingat yang dapat dipilih aplikasi sharer untuk ditampilkan. Properti berguna ketika undangan digunakan untuk mengautentikasi beberapa peserta karena memungkinkan pembagian dan pemirsa lain untuk mengidentifikasi siapa yang berpartisipasi dalam sesi Berbagi Desktop Windows.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header rdpencomapi.h
DLL RdpEncom.dll

Lihat juga

IRDPSRAPIViewer