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

IRendezvousApplication

COM
📘 Microsoft Learn (日本語) · English
IID4f4d070b-a275-49fb-b10d-8ec26387b50d継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

インスタントメッセージング(IM)アプリケーションがリモートアシスタンスセッションを作成するために使用するメソッドを公開します。

解説(Remarks)

IM の連絡先がリモートアシスタンスの招待を承諾した後、IM アプリケーションは接続の両側で Windows リモートアシスタンスアプリケーションをインスタンス化する必要があります。これは、Windows リモートアシスタンスアプリケーションの IRendezvousApplication インターフェイスに対して CoCreateInstance を呼び出すことで行います。

IM アプリケーションは SetRendezvousSession メソッドを呼び出して、自身が実装した IRendezvousSession インターフェイスを Windows リモートアシスタンスアプリケーションに渡します。

メソッド 1

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

vtbl 3 HRESULT SetRendezvousSession(IUnknown* pRendezvousSession)

IRendezvousSession を Windows リモートアシスタンスアプリケーションに渡します。このメソッドはインスタントメッセージングアプリケーションによって使用されます。

pRendezvousSessionIUnknown*inoptionalIRendezvousSession

戻り値

このメソッドは次のいずれかの値を返すことがあります。

戻り値コード 説明
S_OK
 IRendezvousSession が Windows リモートアシスタンスアプリケーションに正常に渡されました。
E_INVALIDARG
 メソッドに渡されたセッションオブジェクトが無効です。
E_FAIL
 セッションを Windows リモートアシスタンスアプリケーションに渡そうとしている間に致命的なエラーが発生しました。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IRendezvousApplication "{4F4D070B-A275-49FB-B10D-8EC26387B50D}"
#usecom global IRendezvousApplication IID_IRendezvousApplication "{0B7E019A-B5DE-47FA-8966-9082F82FB192}"
#comfunc global IRendezvousApplication_SetRendezvousSession  3 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。