Metode IRDPSRAPIViewer::StartReverseConnectListener (rdpencomapi.h)

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

Memulai pendengar untuk menerima koneksi terbalik dari sharer ke penampil, atau mendapatkan string koneksi yang digunakan pembagi untuk menyambungkan balik ke penampil.

Sintaks

HRESULT StartReverseConnectListener(
  [in]  BSTR bstrConnectionString,
  [in]  BSTR bstrUserName,
  [in]  BSTR bstrPassword,
  [out] BSTR *pbstrReverseConnectString
);

Parameter

[in] bstrConnectionString

Jenis: BSTR

String koneksi yang akan digunakan sharer untuk memulai pendengar.

[in] bstrUserName

Jenis: BSTR

Nama pengguna yang digunakan untuk autentikasi.

[in] bstrPassword

Jenis: BSTR

Kata sandi yang digunakan untuk autentikasi.

[out] pbstrReverseConnectString

Jenis: BSTR*

Penunjuk ke BSTR yang menerima string koneksi yang dapat digunakan pembagi untuk menyambungkan balik ke penampil dengan menggunakan metode IRDPSRAPISharingSession::ConnectToClient .

Nilai kembali

Jenis: HRESULT

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

Keterangan

Metode ini digunakan untuk melakukan dua operasi terpisah:

• Yang pertama adalah mengizinkan penampil untuk mendapatkan string koneksi yang digunakan pembagi untuk menyambungkan balik ke penampil. Untuk melakukannya, parameter bstrConnectionString, bstrUserName, dan bstrPassword semuanya harus NULL. Penampil kemudian mengirim string koneksi ini ke sharer dalam metode yang ditentukan aplikasi, seperti menyimpan string koneksi dalam file dan berbagi file dengan sharer.
• Operasi kedua adalah memulai pendengar yang akan watch untuk upaya koneksi terbalik dari sharer. Untuk operasi ini, parameter pbstrReverseConnectString harus NULL.

Urutan normal peristiwa untuk prosedur ini adalah sebagai berikut:

1. Penampil mendapatkan string koneksinya dengan memanggil metode StartReverseConnectListener , meneruskan NULL untuk parameter bstrConnectionString, bstrUserName, dan bstrPassword .
2. Penampil memulai listener koneksi terbalik dengan memanggil metode StartReverseConnectListener , meneruskan NULL untuk parameter pbstrReverseConnectString dan nilai yang valid untuk parameter bstrConnectionString, bstrUserName, dan bstrPassword .
3. Penampil mengirim string koneksi yang diperoleh di langkah 1 ke sharer.

Persyaratan

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