IMsTscAxEvents インターフェイス

  • [アーティクル]

クライアント コントロール イベントに関連する情報をサーバーから受信するメソッドが含まれます。 イベントには、接続と切断、全画面表示モードの要求、ログオンの成功、エラー状態が含まれます。

メンバー

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

メソッド

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

Method 説明
OnAuthenticationWarningDismissed ActiveX コントロールが認証ダイアログ ボックス (証明書エラー ダイアログ ボックスなど) を表示した後に呼び出されます。
OnAuthenticationWarningDisplayed ActiveX コントロールが認証ダイアログ ボックス (証明書エラー ダイアログ ボックスなど) を表示する前に呼び出されます。
OnAutoReconnected クライアント コントロールがリモート セッションに自動的に再接続したときに呼び出されます。
OnAutoReconnecting クライアントが RD セッション ホスト サーバーとのセッションを自動的に再接続する処理中に呼び出されます。
OnAutoReconnecting2 クライアントが RD セッション ホスト サーバーとのセッションを自動的に再接続する処理中に呼び出されます。
OnChannelReceivedData クライアントがスクリプト可能な仮想チャネルでデータを受信するときに呼び出されます。
OnConfirmClose クライアントが IMsRdpClient::RequestClose メソッドを呼び出すときに呼び出されます。
OnConnected クライアント コントロールが RD セッション ホスト サーバーとの接続を確立しているときに呼び出されます。
OnConnecting クライアント コントロールが IMsTscAx::Connect の呼び出しに応答してサーバーへの接続を開始するときに呼び出されます。
OnConnectionBarPullDown ユーザーが接続バーを下にドラッグしたときに呼び出されます。
OnDevicesButtonPressed 接続バーの [デバイス] ボタンが押されたときに呼び出されます。
OnDisconnected クライアント コントロールが RD セッション ホスト サーバーから切断されたときに呼び出されます。
OnEnterFullScreenMode クライアントが全画面表示モードになったときに呼び出されます。 たとえば、ユーザーが全画面表示モードの ショートカット キー の組み合わせを押すと、このイベントが呼び出されます (Ctrl + Alt + BREAK)。
OnFatalError クライアント コントロールで致命的なエラーが発生したときに呼び出されます。
OnFocusReleased リリース フォーカス キーの組み合わせが押されたときに呼び出されます。 たとえば、ユーザーが Ctrl + Alt + ← キーまたは Ctrl + Alt + 右方向キーの組み合わせを押すと、このイベントが呼び出されます。
OnIdleTimeoutNotification IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout メソッドによって設定された期間にユーザーがマウスまたはキーボード入力を行っていない場合に呼び出されます。
OnLeaveFullScreenMode クライアントが全画面表示モードを離れると呼び出されます。 たとえば、ユーザーが全画面表示モードの ショートカット キー の組み合わせを押すと、このイベントが呼び出されます (Ctrl + Alt + BREAK)。
OnLoginComplete [Windows ログオン] ダイアログ ボックスの表示に従って、クライアント コントロールが RD セッション ホスト サーバーに正常にログオンしたときに呼び出されます。
OnLogonError ログオン エラーまたはその他のログオン イベントが発生したときに呼び出されます。
OnMouseInputModeChanged マウス入力モードが変更されたときに呼び出されます。
OnNetworkStatusChanged ネットワークの状態が変更されたときに呼び出されます。
OnReceivedTSPublicKey クライアントがサーバーから公開キーを取得するときに、接続シーケンス中に呼び出されます。 このイベントは、 NotifyTSPublicKey プロパティがVARIANT_TRUE場合にのみ呼び出 されます。
OnRemoteDesktopSizeChange リモート デスクトップ上のクライアント コントロールのサイズが、クライアント コントロール操作に応じて変更されたことを示すために呼び出されます。
OnRemoteProgramDisplayed RemoteApp プログラムが表示されるときに呼び出されます。
OnRemoteProgramResult RemoteApp プログラムがクライアント コントロールに結果を返すときに呼び出されます。
OnRemoteWindowDisplayed RemoteApp ウィンドウが表示されるときに呼び出されます。
OnRequestContainerMinimize ユーザーが全画面表示モードで接続バーの [最小化 ] ボタンを押すと呼び出されます。 このイベントの発生は、コンテナー アプリケーション自体を最小限に抑える要求です。
OnRequestGoFullScreen クライアントが全画面表示モードへの切り替えを要求し、 IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen メソッドを呼び出して ContainerHandledFullScreen プロパティを 0 以外の値に設定すると呼び出されます。
OnRequestLeaveFullScreen クライアントが全画面表示モードの終了を要求し、 IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen プロパティが 0 以外の値に設定されている場合に呼び出されます。
OnServiceMessageReceived クライアントがシステム メッセージを受信したときに呼び出されます。
OnUserNameAcquired コントロールによってユーザー名が取得されたときに呼び出されます。
OnWarning 致命的ではないエラー条件がクライアント コントロールで検出されたときに呼び出されます。

解説

リモート デスクトップ Web 接続の詳細については、「リモート デスクトップ Web 接続 の要件」を参照してください。

RDP クライアント制御オブジェクト (MsRdpClient、 MsRdpClientNonScriptable 、およびその派生物) は、接続可能なオブジェクトです。 リモート セッションに関するリモート デスクトップ ActiveX コントロールからイベントを受信するには、アプリケーションで IMstscAxEvents を 実装し、次の手順を実行します。

  1. RDP クライアント コントロール オブジェクトで IUnknown::QueryInterface を呼び出して 、IConnectionPointContainer インターフェイスへのポインターを取得します。
  2. クライアント コントロール イベントの IConnectionPoint インターフェイスへのポインターを__uuidof(IMsTscAxEvents)取得するには、riid パラメーターとして指定して IConnectionPointContainer::FindConnectionPoint を呼び出します。
  3. IConnectionPoint::Advise を呼び出して、イベントをディスパッチする呼び出し元アプリケーション独自の IMsTscAxEvents の実装を指定します。

アプリケーションでは、 IDispatch::Invoke を実装するときに、次の DISPID を使用できます。

dispIdMember メソッドへのディスパッチ
DISPID_CONNECTING = 1 OnConnecting
DISPID_CONNECTED = 2 OnConnected
DISPID_LOGINCOMPLETE = 3 OnLoginComplete
DISPID_DISCONNECTED = 4 OnDisconnected
DISPID_ENTERFULLSCREENMODE = 5 OnEnterFullScreenMode
DISPID_LEAVEFULLSCREENMODE = 6 OnLeaveFullScreenMode
DISPID_CHANNELRECEIVEDDATA = 7 OnChannelReceivedData
DISPID_REQUESTGOFULLSCREEN = 8 OnRequestGoFullScreen
DISPID_REQUESTLEAVEFULLSCREEN = 9 OnRequestLeaveFullScreen
DISPID_FATALERROR = 10 OnFatalError
DISPID_WARNING = 11 OnWarning
DISPID_REMOTEDESKTOPSIZECHANGE = 12 OnRemoteDesktopSizeChange
DISPID_IDLETIMEOUTNOTIFICATION = 13 OnIdleTimeoutNotification
DISPID_REQUESTCONTAINERMINIMIZE = 14 OnRequestContainerMinimize
DISPID_CONFIRMCLOSE = 15 OnConfirmClose
DISPID_RECEIVEDTSPUBLICKEY = 16 OnReceivedTSPublicKey
DISPID_AUTORECONNECTING = 17 OnAutoReconnecting
DISPID_INTERNALDIALOGDISPLAYED = 18 OnAuthenticationWarningDisplayed
DISPID_INTERNALDIALOGDISMISSED = 19 OnAuthenticationWarningDismissed
DISPID_ONREMOTEPROGRAMRESULT = 20 OnRemoteProgramResult
DISPID_ONREMOTEPROGRAMDISPLAYED = 21 OnRemoteProgramDisplayed
DISPID_LOGONERROR = 22 OnLogonError
DISPID_FOCUSRELEASED = 23 OnFocusReleased
DISPID_USERNAMEACQUIRED = 24 OnUserNameAcquired
DISPID_MOUSEINPUTMODECHANGED = 26 OnMouseInputModeChanged
DISPID_ONSTATUSINFO = 27 [なし] : アプリケーションにVT_UI4状態コードを提供します。 アプリケーションは、'pDispParams-rgvarg>[0].ulVal'' に含まれる状態コードを IMsRdpClient7::GetStatusText に渡して、関連付けられた状態テキストを取得できます。
DISPID_SERVICEMESSAGERECEIVED = 28 OnServiceMessageReceived
DISPID_ONREMOTEWINDOWDISPLAYED = 29 OnRemoteWindowDisplayed
DISPID_CONNECTIONBARPULLDOWN = 30 OnConnectionBarPullDown
DISPID_ONNETWORKSTATUSCHANGED = 32 OnNetworkStatusChanged
DISPID_AUTORECONNECTED = 33 OnAutoReconnected
DISPID_AUTORECONNECTING2 = 34 OnAutoReconnecting2
DISPID_CONNECTIONBARDEVICES = 35 OnDevicesButtonPressed
DISPID_HVSINOTIFICATION = 36 [なし] : VT_UI4 イベント コードを提供します。 このイベントは、Microsoft Defender Application Guardシナリオで生成されます。 通常の操作中は出力しないでください。
DISPID_ONWOKEUPANDRECONNECTING = 37 [なし] : このイベントは、リモート デスクトップ ActiveX コントロールによって生成されなくなりました。
DISPID_ONLOCATIONREDIRECTIONENABLEDRECEIVED = 39 [なし] : このイベントは、クライアントの地理的な場所をリモート セッションに反映できるように、 IMsRdpClientNonScriptable6::SendLocation2D または IMsRdpClientNonScriptable6::SendLocation3D の使用を開始できることをアプリケーションに通知します。

必要条件

要件 値
サポートされている最小のクライアント
 Windows Vista
サポートされている最小のサーバー
 Windows Server 2008
タイプ ライブラリ
MsTscAx.dll
[DLL]
MsTscAx.dll
CLSID
 CLSID_MsRdpClientは 791fa017-2de3-492e-acc5-53c67a2b94d0 として定義されています
CLSID_MsRdpClient10は、C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 として定義されます
CLSID_MsRdpClient10NotSafeForScriptingは、A0C63C30-F08D-4AB4-907C-34905D770C7D として定義されます
CLSID_MsRdpClient2は 9059F30F-4EB1-4BD2-9FDC-36F43A218F4A として定義されています
CLSID_MsRdpClient2aは 971127BB-259F-48C2-BD75-5F97A3331551 として定義されています
CLSID_MsRdpClient2NotSafeForScriptingは 3523C2FB-4031-44E4-9A3B-F1E94986EE7F として定義されます
CLSID_MsRdpClient3は 7584C670-2274-4EFB-B00B-D6AABA6D3850として定義されます
CLSID_MsRdpClient3aは 6A6F4B83-45C5-4CA9-BDD9-0D81C12295E4 として定義されています
CLSID_MsRdpClient3NotSafeForScriptingは、ACE575FD-1FCF-4074-9401-EBAB990FA9DE として定義されます
CLSID_MsRdpClient4は 4EDCB26C-D24C-4E72-AF07-B576699AC0DE として定義されます
CLSID_MsRdpClient4aは 54CE37E0-9834-41AE-9896-4DAB69DC022B として定義されます
CLSID_MsRdpClient4NotSafeForScriptingは 6AE29350-321B-42BE-BBE5-12FB5270C0DE として定義されます
CLSID_MsRdpClient5は 4EB89FF4-7F78-4A0F-8B8D-2BF02E94E4B2 として定義されています
CLSID_MsRdpClient5NotSafeForScriptingは 4EB2F086-C818-447E-B32C-C51CE2B30D31 として定義されます
CLSID_MsRdpClient6は 7390F3D8-0439-4C05-91E3-CF5CB290C3D0 として定義されます
CLSID_MsRdpClient6NotSafeForScriptingは、D2EA46A7-C2BF-426B-AF24-E19C44456399として定義されます
CLSID_MsRdpClient7は、A9D7038D-B5ED-472E-9C47-94BEA90A5910 として定義されています
CLSID_MsRdpClient7NotSafeForScriptingは 54D38BF7-B1EF-4479-9674-1BD6EA465258 として定義されています
CLSID_MsRdpClient8は 5F681803-2900-4C43-A1CC-CF405404A676 として定義されています
CLSID_MsRdpClient8NotSafeForScriptingは、A3BC03A0-041D-42E3-AD22-882B7865C9C5 として定義されています
CLSID_MsRdpClient9は 301B94BA-5D25-4A12-BFFE-3B6E7A616585 として定義されています
CLSID_MsRdpClient9NotSafeForScriptingは 8B918B82-7985-4C24-89DF-C33AD2BBFBCD として定義されています
CLSID_MsRdpClientNotSafeForScriptingは 7CACBD7B-0D99-468F-AC33-22E495C0AFE5 として定義されています
CLSID_MsTscAxは 1FB464C8-09BB-4017-A2F5-EB742F04392F として定義されています
CLSID_MsTscAxNotSafeForScriptingは、A41A4187-5A86-4E26-B40A-856F9035D9CB として定義されています
IID
 IID_IMsTscAxEventsは 336d5562-efa8-482e-8cb3-c5c0fc7a7db6 として定義されています

こちらもご覧ください

IDispatch

リモート デスクトップ Web 接続リファレンス