Antarmuka IWTSProtocolConnection (wtsprotocol.h)

[IWTSProtocolConnection tidak lagi tersedia untuk digunakan pada Windows Server 2012. Sebagai gantinya, gunakan IWRdsProtocolConnection.]

Mengekspos metode yang dipanggil oleh layanan Layanan Desktop Jauh untuk mengonfigurasi koneksi klien. Protokol Anda harus menerapkan antarmuka ini untuk menangani permintaan koneksi dari klien. Ketika pendengar protokol menerima permintaan koneksi dari klien, pendengar harus membuat objek IWTSProtocolConnection dan meneruskannya ke layanan Layanan Desktop Jarak Jauh dengan memanggil metode OnConnected . Sebagai respons, layanan menambahkan referensi ke objek IWTSProtocolConnectionCallback dan mengembalikan penunjuk ke objek tersebut. Ketika koneksi tidak lagi diperlukan, protokol harus melepaskan penunjuk.

Selama urutan koneksi, metode berikut dipanggil oleh layanan Layanan Desktop Jauh dalam urutan yang tercantum.

1. GetLogonErrorRedirector
2. SendPolicyData
3. AcceptConnection
4. GetClientData
5. GetUserCredentials
6. GetLicenseConnection
7. AuthenticateClientToSession
8. NotifySessionId
9. GetProtocolHandles
10. ConnectNotify
11. IsUserAllowedToLogon
12. SessionArbitrationEnumeration
13. LogonNotify
14. GetUserData

Jika layanan Layanan Desktop Jarak Jauh perlu terhubung kembali setelah memanggil SessionArbitrationEnumeration, layanan ini terhubung kembali dengan memanggil metode berikut dalam urutan yang tercantum:

1. DisconnectNotify (Dipanggil pada sesi baru yang dibuat.)
2. NotifySessionId (Dipanggil pada sesi yang ada.)
3. GetProtocolHandles
4. ConnectNotify
5. LogonNotify

Untuk memutuskan sambungan, layanan Layanan Desktop Jarak Jauh memanggil metode berikut dalam urutan yang tercantum:

1. Putuskan SambunganNotify
2. Tutup

Layanan Layanan Desktop Jauh dapat memanggil metode berikut kapan saja setelah koneksi dibuat:

• GetProtocolStatus
• GetLastInputTime
• SetErrorInfo
• SendBeep
• CreateVirtualChannel
• QueryProperty
• GetShadowConnection

Warisan

Antarmuka IWTSProtocolConnection mewarisi dari antarmuka IUnknown . IWTSProtocolConnection juga memiliki jenis anggota ini:

Metode

Antarmuka IWTSProtocolConnection memiliki metode ini.

IWTSProtocolConnection::AcceptConnection IWTSProtocolConnection::AcceptConnection tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::AcceptConnection.
IWTSProtocolConnection::AuthenticateClientToSession IWTSProtocolConnection::AuthenticateClientToSession tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::AuthenticateClientToSession.
IWTSProtocolConnection::Close IWTSProtocolConnection::Close tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::Close.
IWTSProtocolConnection::ConnectNotify IWTSProtocolConnection::ConnectNotify tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::ConnectNotify.
IWTSProtocolConnection::CreateVirtualChannel IWTSProtocolConnection::CreateVirtualChannel tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::CreateVirtualChannel.
IWTSProtocolConnection::D isconnectNotify IWTSProtocolConnection::D isconnectNotify tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::D isconnectNotify.
IWTSProtocolConnection::GetClientData IWTSProtocolConnection::GetClientData tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::GetClientData.
IWTSProtocolConnection::GetLastInputTime IWTSProtocolConnection::GetLastInputTime tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::GetLastInputTime.
IWTSProtocolConnection::GetLicenseConnection IWTSProtocolConnection::GetLicenseConnection tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::GetLicenseConnection.
IWTSProtocolConnection::GetLogonErrorRedirector IWTSProtocolConnection::GetLogonErrorRedirector tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::GetLogonErrorRedirector.
IWTSProtocolConnection::GetProtocolHandles IWTSProtocolConnection::GetProtocolHandles tidak lagi tersedia.
IWTSProtocolConnection::GetProtocolStatus IWTSProtocolConnection::GetProtocolStatus tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::GetProtocolStatus.
IWTSProtocolConnection::GetShadowConnection IWTSProtocolConnection::GetShadowConnection tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::GetShadowConnection.
IWTSProtocolConnection::GetUserCredentials IWTSProtocolConnection::GetUserCredentials tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::GetUserCredentials.
IWTSProtocolConnection::GetUserData IWTSProtocolConnection::GetUserData tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolSettings::MergeSettings.
IWTSProtocolConnection::IsUserAllowedToLogon IWTSProtocolConnection::IsUserAllowedToLogon tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::IsUserAllowedToLogon.
IWTSProtocolConnection::LogonNotify IWTSProtocolConnection::LogonNotify tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::LogonNotify.
IWTSProtocolConnection::NotifySessionId IWTSProtocolConnection::NotifySessionId tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::NotifySessionId.
IWTSProtocolConnection::QueryProperty IWTSProtocolConnection::QueryProperty tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::QueryProperty.
IWTSProtocolConnection::SendBeep IWTSProtocolConnection::SendBeep tidak lagi tersedia.
IWTSProtocolConnection::SendPolicyData IWTSProtocolConnection::SendPolicyData tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolManager::NotifySettingsChange.
IWTSProtocolConnection::SessionArbitrationEnumeration IWTSProtocolConnection::SessionArbitrationEnumeration tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::SessionArbitrationEnumeration.
IWTSProtocolConnection::SetErrorInfo IWTSProtocolConnection::SetErrorInfo tidak lagi tersedia. Sebagai gantinya, gunakan IWRdsProtocolConnection::SetErrorInfo.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2008 R2
Target Platform	Windows
Header	wtsprotocol.h