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

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

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

1. GetLogonErrorRedirector
2. AcceptConnection
3. GetClientData
4. GetClientMonitorData
5. GetUserCredentials
6. GetLicenseConnection
7. AuthenticateClientToSession
8. NotifySessionId
9. GetInputHandles
10. GetVideoHandle
11. ConnectNotify
12. NotifyCommandProcessCreated
13. IsUserAllowedToLogon
14. SessionArbitrationEnumeration
15. LogonNotify

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

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

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

1. PreDisconnect
2. DisconnectNotify
3. 閉じる

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

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

継承

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

メソッド

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

IWRdsProtocolConnection::AcceptConnection 接続要求を続行するようにプロトコルに指示します。
IWRdsProtocolConnection::AuthenticateClientToSession 接続を再接続する必要があるセッションを指定します。
IWRdsProtocolConnection::Close セッションが切断された後に接続を閉じます。
IWRdsProtocolConnection::ConnectNotify セッションが初期化されたことをプロトコルに通知します。
IWRdsProtocolConnection::CreateVirtualChannel プロトコルで仮想チャネルを作成することを要求します。
IWRdsProtocolConnection::D isconnectNotify セッションが切断されたことをプロトコルに通知します。
IWRdsProtocolConnection::GetClientData プロトコルからクライアント設定を要求します。
IWRdsProtocolConnection::GetClientMonitorData クライアント上のモニターの数とプライマリ モニター番号を取得します。
IWRdsProtocolConnection::GetInputHandles プロトコルの入出力デバイスへのハンドルを取得します。
IWRdsProtocolConnection::GetLastInputTime プロトコルが最後にユーザー入力を受信した時刻を取得します。
IWRdsProtocolConnection::GetLicenseConnection クライアント ライセンス プロセスの開始に使用される IWRdsProtocolLicenseConnection オブジェクトを取得します。
IWRdsProtocolConnection::GetLogonErrorRedirector プロトコルでクライアント ログオン エラーを処理する方法を指定する IWRdsProtocolLogonErrorRedirector インターフェイスを取得します。
IWRdsProtocolConnection::GetProtocolStatus プロトコルの状態に関する情報を取得します。
IWRdsProtocolConnection::GetShadowConnection プロトコルからシャドウ接続オブジェクトへの参照を取得します。
IWRdsProtocolConnection::GetUserCredentials ユーザー資格情報を返します。
IWRdsProtocolConnection::GetVideoHandle プロトコルのビデオ デバイスのハンドルを取得します。
IWRdsProtocolConnection::IsUserAllowedToLogon ユーザーがセッションにログオンできるかどうかをプロトコルから判断します。
IWRdsProtocolConnection::LogonNotify ユーザーがセッションにログオンしたときに呼び出されます。
IWRdsProtocolConnection::NotifyCommandProcessCreated Winlogon.exe プロセスが作成および初期化されたことをプロトコルに通知します。
IWRdsProtocolConnection::NotifySessionId 新しいセッションの識別子をプロトコルに送信します。
IWRdsProtocolConnection::P reDisconnect セッションが切断されようとしていることをプロトコルに通知します。
IWRdsProtocolConnection::QueryProperty プロトコルからプロパティ値を取得します。
IWRdsProtocolConnection::SessionArbitrationEnumeration プロトコルが再接続するセッションを指定できるように、調停後に呼び出されます。
IWRdsProtocolConnection::SetErrorInfo プロトコルのエラー情報を設定します。

注釈

このインターフェイスでいずれかのメソッドを呼び出すときにデッドロックが発生しないようにするには、リモート デスクトップ サービス API が直接または間接的に呼び出される関数またはメソッド呼び出しを行わないでください。 送信呼び出しを行う必要がある場合は、新しいスレッドを開始し、新しいスレッドから送信呼び出しを行う必要があります。

要件

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