Win32 API 日本語リファレンス
ホーム › System.RemoteDesktop › IWTSProtocolListener

IWTSProtocolListener

COM
📘 Microsoft Learn (日本語) · English
IID23083765-45f0-4394-8f69-32b2bc0ef4ca継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IWTSProtocolListener は現在は使用できません。代わりに IWRdsProtocolListener を使用してください。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT StartListen(IWTSProtocolListenerCallback* pCallback)

IWTSProtocolListener::StartListen は現在は使用できません。代わりに IWRdsProtocolListener::StartListen を使用してください。

pCallbackIWTSProtocolListenerCallback*in

リモートデスクトップサービスによって実装された IWTSProtocolListenerCallback オブジェクトへのポインター。 プロトコルは、この IWTSProtocolListenerCallback オブジェクトを使用して、

リモートデスクトップサービス に対して受信接続要求を通知します。プロトコルはこのオブジェクトへの参照を追加し、 StopListen が呼び出されたときに解放する必要があります。

戻り値

このメソッドを実装する際は、関数が成功した場合は S_OK を返してください。失敗した場合は、 エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、 Common HRESULT Values を参照してください。

解説(Remarks)

StartListen メソッドは、リモートデスクトップサービスの開始時に呼び出されます。

  1. リモートデスクトップサービスは CoCreateInstance を呼び出して IWTSProtocolManager オブジェクトを作成します。
  2. リモートデスクトップサービスは IWTSProtocolManager インターフェイスの CreateListener を呼び出します。プロトコルは IWTSProtocolListener オブジェクトを作成し、それをリモートデスクトップサービスに返します。
  3. リモートデスクトップサービスは IWTSProtocolListener オブジェクトの StartListen を呼び出します。
vtbl 4 HRESULT StopListen()

IWTSProtocolListener::StopListen は現在は使用できません。代わりに IWRdsProtocolListener::StopListen を使用してください。

戻り値

このメソッドを実装する際は、関数が成功した場合は S_OK を返してください。失敗した場合は、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IWTSProtocolListener "{23083765-45F0-4394-8F69-32B2BC0EF4CA}"
#usecom global IWTSProtocolListener IID_IWTSProtocolListener "{}"
#comfunc global IWTSProtocolListener_StartListen  3 sptr
#comfunc global IWTSProtocolListener_StopListen   4
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。