IWTSProtocolConnection インターフェイス (wtsprotocol.h)

[IWTSProtocolConnection は、Windows Server 2012の時点で使用できなくなります。 代わりに、 IWRdsProtocolConnection を使用します。

クライアント接続を構成するためにリモート デスクトップ サービス サービスによって呼び出されるメソッドを公開します。 プロトコルでは、クライアントからの接続要求を処理するために、このインターフェイスを実装する必要があります。 プロトコル リスナーは、クライアントから接続要求を受信するときに、 IWTSProtocolConnection オブジェクトを作成し、 OnConnected メソッドを呼び出してリモート デスクトップ サービス サービスに渡す必要があります。 応答として、サービスは IWTSProtocolConnectionCallback オブジェクトへの参照を追加し、そのオブジェクトへのポインターを返します。 接続が不要になった場合、プロトコルはポインターを解放する必要があります。

接続シーケンス中に、リモート デスクトップ サービス サービスによって、一覧表示されている順序で次のメソッドが呼び出されます。

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

SessionArbitrationEnumeration を呼び出した後にリモート デスクトップ サービス サービスを再接続する必要がある場合は、リストされている順序で次のメソッドを呼び出して再接続します。

1. DisconnectNotify (作成された新しいセッションで呼び出されます)。
2. NotifySessionId (既存のセッションで呼び出されます)。
3. GetProtocolHandles
4. ConnectNotify
5. LogonNotify

切断するには、リモート デスクトップ サービス サービスは、一覧に示されている順序で次のメソッドを呼び出します。

1. DisconnectNotify
2. 閉じる

リモート デスクトップ サービス サービスは、接続が確立された後、いつでも次のメソッドを呼び出すことができます。

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

継承

IWTSProtocolConnection インターフェイスは、IUnknown インターフェイスから継承されます。 IWTSProtocolConnection には、次の種類のメンバーもあります。

メソッド

IWTSProtocolConnection インターフェイスには、これらのメソッドがあります。

IWTSProtocolConnection::AcceptConnection IWTSProtocolConnection::AcceptConnection は使用できなくなりました。 代わりに、IWRdsProtocolConnection::AcceptConnection を使用します。
IWTSProtocolConnection::AuthenticateClientToSession IWTSProtocolConnection::AuthenticateClientToSession は使用できなくなりました。 代わりに、IWRdsProtocolConnection::AuthenticateClientToSession を使用します。
IWTSProtocolConnection::Close IWTSProtocolConnection::Close は使用できなくなりました。 代わりに、IWRdsProtocolConnection::Close を使用します。
IWTSProtocolConnection::ConnectNotify IWTSProtocolConnection::ConnectNotify は使用できなくなりました。 代わりに、IWRdsProtocolConnection::ConnectNotify を使用します。
IWTSProtocolConnection::CreateVirtualChannel IWTSProtocolConnection::CreateVirtualChannel は使用できなくなりました。 代わりに、IWRdsProtocolConnection::CreateVirtualChannel を使用します。
IWTSProtocolConnection::D isconnectNotify IWTSProtocolConnection::D isconnectNotify は使用できなくなりました。 代わりに、IWRdsProtocolConnection::D isconnectNotify を使用します。
IWTSProtocolConnection::GetClientData IWTSProtocolConnection::GetClientData は使用できなくなりました。 代わりに、IWRdsProtocolConnection::GetClientData を使用します。
IWTSProtocolConnection::GetLastInputTime IWTSProtocolConnection::GetLastInputTime は使用できなくなりました。 代わりに、IWRdsProtocolConnection::GetLastInputTime を使用します。
IWTSProtocolConnection::GetLicenseConnection IWTSProtocolConnection::GetLicenseConnection は使用できなくなりました。 代わりに、IWRdsProtocolConnection::GetLicenseConnection を使用します。
IWTSProtocolConnection::GetLogonErrorRedirector IWTSProtocolConnection::GetLogonErrorRedirector は使用できなくなりました。 代わりに、IWRdsProtocolConnection::GetLogonErrorRedirector を使用します。
IWTSProtocolConnection::GetProtocolHandles IWTSProtocolConnection::GetProtocolHandles は使用できなくなりました。
IWTSProtocolConnection::GetProtocolStatus IWTSProtocolConnection::GetProtocolStatus は使用できなくなりました。 代わりに、IWRdsProtocolConnection::GetProtocolStatus を使用します。
IWTSProtocolConnection::GetShadowConnection IWTSProtocolConnection::GetShadowConnection は使用できなくなりました。 代わりに、IWRdsProtocolConnection::GetShadowConnection を使用します。
IWTSProtocolConnection::GetUserCredentials IWTSProtocolConnection::GetUserCredentials は使用できなくなりました。 代わりに、IWRdsProtocolConnection::GetUserCredentials を使用します。
IWTSProtocolConnection::GetUserData IWTSProtocolConnection::GetUserData は使用できなくなりました。 代わりに、IWRdsProtocolSettings::MergeSettings を使用します。
IWTSProtocolConnection::IsUserAllowedToLogon IWTSProtocolConnection::IsUserAllowedToLogon は使用できなくなりました。 代わりに、IWRdsProtocolConnection::IsUserAllowedToLogon を使用します。
IWTSProtocolConnection::LogonNotify IWTSProtocolConnection::LogonNotify は使用できなくなりました。 代わりに、IWRdsProtocolConnection::LogonNotify を使用します。
IWTSProtocolConnection::NotifySessionId IWTSProtocolConnection::NotifySessionId は使用できなくなりました。 代わりに、IWRdsProtocolConnection::NotifySessionId を使用します。
IWTSProtocolConnection::QueryProperty IWTSProtocolConnection::QueryProperty は使用できなくなりました。 代わりに、IWRdsProtocolConnection::QueryProperty を使用します。
IWTSProtocolConnection::SendBeep IWTSProtocolConnection::SendBeep は使用できなくなりました。
IWTSProtocolConnection::SendPolicyData IWTSProtocolConnection::SendPolicyData は使用できなくなりました。 代わりに、IWRdsProtocolManager::NotifySettingsChange を使用します。
IWTSProtocolConnection::SessionArbitrationEnumeration IWTSProtocolConnection::SessionArbitrationEnumeration は使用できなくなりました。 代わりに、IWRdsProtocolConnection::SessionArbitrationEnumeration を使用します。
IWTSProtocolConnection::SetErrorInfo IWTSProtocolConnection::SetErrorInfo は使用できなくなりました。 代わりに、IWRdsProtocolConnection::SetErrorInfo を使用します。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008 R2
対象プラットフォーム	Windows
ヘッダー	wtsprotocol.h