MsRdpClient4 クラス
Microsoft RDP クライアント制御 (再頒布可能パッケージ) - バージョン 5
このクラスは、次のインターフェイスを実装します。
- IMsRdpClient4
- IMsRdpClient3
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
- IMsRdpClientNonScriptable2
MsRdpClient4 には、次の種類のメンバーがあります。
メソッド
MsRdpClient4 クラスには、これらのメソッドがあります。
| メソッド | 説明 |
|---|---|
| 接続 | コントロールで現在設定されているプロパティを使用して接続を開始します。 |
| CreateVirtualChannels | 指定した仮想チャネル名ごとにクライアント側の仮想チャネル オブジェクトを作成します。 |
| [接続解除] | アクティブな接続を切断します。 |
| GetVirtualChannelOptions | 仮想チャネルのオプション セットを取得します。 |
| NotifyRedirectDeviceChange | デバイスの変更がシステムで発生したことをリモート デスクトップ ActiveX コントロールのデバイス リダイレクト モジュールに通知します。 このメソッドは、 WM_DEVICECHANGE 通知をコントロールに渡します。 |
| 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 | 致命的ではないエラー条件がクライアント コントロールで検出されたときに呼び出されます。 |
| RequestClose | クライアント コントロールの正常なシャットダウンを要求します。 |
| ResetPassword | コントロール内のすべてのパスワード状態をリセットします。 |
| SendKeys | 一連のキーストロークをコントロールに送信します。 キーストロークは、実際の物理キーからのキーボード データであるスキャン コード形式です。 |
| SendOnVirtualChannel |
IMsTscAx::CreateVirtualChannels メソッドを使用して、以前に作成された仮想チャネル経由で RD セッション ホスト サーバーにデータを送信します。 |
| SetVirtualChannelOptions | クライアント コントロールの仮想チャネル オプションを設定します。 |
プロパティ
MsRdpClient4 クラスには、これらのプロパティがあります。
| プロパティ | アクセスの種類 | 説明 |
|---|---|---|
|
AdvancedSettings |
読み取り専用 |
IMsTscAdvancedSettings インターフェイス ポインター。 |
|
AdvancedSettings2 |
読み取り専用 |
クライアント コントロールの詳細設定を設定するために使用 される IMsRdpClientAdvancedSettings インターフェイスへのポインター。 |
|
AdvancedSettings3 |
読み取り専用 |
クライアント コントロールの詳細設定を設定するために使用 される IMsRdpClientAdvancedSettings2 インターフェイスへのポインター。 |
|
AdvancedSettings4 |
読み取り専用 |
クライアント コントロールの詳細設定を設定するために使用 される IMsRdpClientAdvancedSettings3 インターフェイスへのポインター。 |
|
AdvancedSettings5 |
読み取り専用 |
IMsRdpClientAdvancedSettings4 インターフェイス ポインター。 |
|
BinaryPassword |
読み取り/書き込み |
このプロパティはサポートされていません。 |
|
BinarySalt |
読み取り/書き込み |
このプロパティはサポートされていません。 |
|
CipherStrength |
読み取り専用 |
現在のコントロールの最大暗号化強度。 |
|
ClearTextPassword |
書き込み専用 |
リモート デスクトップ ActiveX コントロールのパスワード (プレーンテキスト形式)。 |
|
ColorDepth |
読み取り/書き込み |
現在のコントロールの色の深さ。 |
|
接続済み |
読み取り専用 |
現在のコントロールの接続状態。 |
|
ConnectedStatusText |
読み取り/書き込み |
コントロールが接続状態の間にコントロールのクライアント領域に表示されるテキスト。 |
|
ConnectingText |
読み取り/書き込み |
コントロールの接続中にコントロールの中央に表示されるテキスト。 |
|
DesktopHeight |
読み取り/書き込み |
初期リモート デスクトップ上の現在のコントロールの高さ (ピクセル単位)。 |
|
DesktopWidth |
読み取り/書き込み |
初期リモート デスクトップ上の現在のコントロールの幅 (ピクセル単位)。 |
|
DisconnectedText |
読み取り/書き込み |
接続が終了する前にコントロールの中央に表示されるテキスト。 |
|
Domain |
読み取り/書き込み |
現在のユーザーがログオンするドメイン。 |
|
ExtendedDisconnectReason |
読み取り専用 |
クライアント コントロールの切断の理由に関する拡張情報。 |
|
フルスクリーン |
読み取り/書き込み |
コントロールが全画面表示モードであるかどうかを示します。 |
|
FullScreenTitle |
書き込み専用 |
コントロールが全画面表示モードのときに表示されるウィンドウ タイトル。 |
|
HorizontalScrollBarVisible |
読み取り専用 |
コントロールに水平スクロール バーが表示されているかどうかを示します。 |
|
PortablePassword |
読み取り/書き込み |
このプロパティはサポートされていません。 |
|
PortableSalt |
読み取り/書き込み |
このプロパティはサポートされていません。 |
|
SecuredSettings |
読み取り専用 |
IMsTscSecuredSettings インターフェイス ポインター。 |
|
SecuredSettings2 |
読み取り専用 |
クライアント コントロールのセキュリティで保護された設定を設定するために使用される 、IMsRdpClientSecuredSettings インターフェイスへのポインター。 |
|
SecuredSettingsEnabled |
読み取り専用 |
IMsTscSecuredSettings インターフェイスを使用できるかどうかを示します。 |
|
サーバー |
読み取り/書き込み |
現在のコントロールが接続されているサーバーの名前。 |
|
StartConnected |
読み取り/書き込み |
コントロールが起動時にすぐに RD セッション ホスト サーバー接続を確立するかどうかを示します。 |
|
UIParentWindowHandle |
読み取り/書き込み |
コントロールの親ウィンドウとなるウィンドウ ハンドル。 これにより、コントロールによって表示されるすべてのウィンドウが、親アプリケーションによって表示されるウィンドウに対して適切にモーダルになります。 |
|
名 |
読み取り/書き込み |
ユーザー名ログオン資格情報。 |
|
Version |
読み取り専用 |
現在のコントロールのバージョン番号。 |
|
VerticalScrollBarVisible |
読み取り専用 |
コントロールに垂直スクロール バーを表示するかどうかを示します。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| タイプ ライブラリ |
|
| [DLL] |
|
| CLSID |
CLSID_MsRdpClient4は 4EDCB26C-D24C-4E72-AF07-B576699AC0DE として定義されます |