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

IRemoteDesktopClient

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID57d25668-625a-4905-be4e-304caa13f89c継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 10

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT Connect()
vtbl 8 HRESULT Disconnect()
vtbl 9 HRESULT Reconnect(DWORD width, DWORD height)
widthDWORDin再接続後のセッション表示領域の幅をピクセル単位で指定する。
heightDWORDin再接続後のセッション表示領域の高さをピクセル単位で指定する。
vtbl 10 HRESULT get_Settings(IRemoteDesktopClientSettings** settings)
settingsIRemoteDesktopClientSettings**outクライアント設定を扱う IRemoteDesktopClientSettings インターフェイスへのポインタを受け取る。
vtbl 11 HRESULT get_Actions(IRemoteDesktopClientActions** actions)
actionsIRemoteDesktopClientActions**outクライアント操作を扱う IRemoteDesktopClientActions インターフェイスへのポインタを受け取る。
vtbl 12 HRESULT get_TouchPointer(IRemoteDesktopClientTouchPointer** touchPointer)
touchPointerIRemoteDesktopClientTouchPointer**outタッチポインタを扱う IRemoteDesktopClientTouchPointer インターフェイスへのポインタを受け取る。
vtbl 13 HRESULT DeleteSavedCredentials(LPWSTR serverName)
serverNameLPWSTRin保存された資格情報を削除する対象サーバー名を表すワイド文字列を指定する。
vtbl 14 HRESULT UpdateSessionDisplaySettings(DWORD width, DWORD height)
widthDWORDin更新後のセッション表示領域の幅をピクセル単位で指定する。
heightDWORDin更新後のセッション表示領域の高さをピクセル単位で指定する。
vtbl 15 HRESULT attachEvent(LPWSTR eventName, IDispatch* callback)
eventNameLPWSTRin登録するイベントの名前を表すワイド文字列を指定する。
callbackIDispatch*inoptionalイベント発生時に呼び出されるコールバックを実装した IDispatch インターフェイスへのポインタである。
vtbl 16 HRESULT detachEvent(LPWSTR eventName, IDispatch* callback)
eventNameLPWSTRin登録を解除するイベントの名前を表すワイド文字列を指定する。
callbackIDispatch*inoptional登録解除する対象のコールバックを実装した IDispatch インターフェイスへのポインタである。

HSP用 COM定義

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

#define global IID_IRemoteDesktopClient "{57D25668-625A-4905-BE4E-304CAA13F89C}"
#usecom global IRemoteDesktopClient IID_IRemoteDesktopClient "{}"
#comfunc global IRemoteDesktopClient_Connect                       7
#comfunc global IRemoteDesktopClient_Disconnect                    8
#comfunc global IRemoteDesktopClient_Reconnect                     9 int,int
#comfunc global IRemoteDesktopClient_get_Settings                  10 sptr
#comfunc global IRemoteDesktopClient_get_Actions                   11 sptr
#comfunc global IRemoteDesktopClient_get_TouchPointer              12 sptr
#comfunc global IRemoteDesktopClient_DeleteSavedCredentials        13 wstr
#comfunc global IRemoteDesktopClient_UpdateSessionDisplaySettings  14 int,int
#comfunc global IRemoteDesktopClient_attachEvent                   15 wstr,sptr
#comfunc global IRemoteDesktopClient_detachEvent                   16 wstr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。