MsRdpClient12 クラス
Microsoft RDP クライアント制御 (再頒布可能パッケージ) - バージョン 13
このクラスは、次のインターフェイスを実装します。
- IMsRdpClient10
- IMsRdpClient9
- IMsRdpClient8
- IMsRdpClient7
- IMsRdpClient6
- IMsRdpClient5
- IMsRdpClient4
- IMsRdpClient3
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
- IMsRdpClientNonScriptable2
- IMsRdpClientNonScriptable3
- IMsRdpClientNonScriptable4
- IMsRdpClientNonScriptable5
- IMsRdpClientNonScriptable6
- IMsRdpClientNonScriptable7
- IMsRdpClientNonScriptable8
- IMsRdpPreferredRedirectionInfo
MsRdpClient12 には、次の種類のメンバーがあります。
メソッド
MsRdpClient12 クラスには、これらのメソッドがあります。
| Method | 説明 |
|---|---|
| attachEvent | イベントをアタッチします。 |
| 接続 | コントロールで現在設定されているプロパティを使用して接続を開始します。 |
| CreateVirtualChannels | 指定した仮想チャネル名ごとにクライアント側の仮想チャネル オブジェクトを作成します。 |
| detachEvent | イベントをデタッチします。 |
| [接続解除] | アクティブな接続を切断します。 |
| GetErrorDescription | エラー コードとエラー メッセージを取得します。 |
| GetStatusText | 指定した状態コードの状態テキストを取得します。 |
| 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 セッション ホスト サーバーにデータを送信します。 |
| SendRemoteAction | リモート セッションでアクションを実行します。 |
| SetVirtualChannelOptions | クライアント コントロールの仮想チャネル オプションを設定します。 |
| SyncSessionDisplaySettings | セッション表示設定を同期します。 |
| UpdateSessionDisplaySettings | セッション表示設定更新します。 |
| SendLocation2D | クライアントの地理的な場所をリモート セッションに反映できるように、緯度と経度の値をサーバーに送信します。 |
| SendLocation3D | クライアントの地理的な場所をリモート セッションに反映できるように、緯度、経度、高度の値をサーバーに送信します。 |
| DisableDpiCursorScalingForProcess | サーバーから受け取ったマウス カーソルのローカル スケーリングを無効にし、変更なしでカーソルの図形が正しくレンダリングされるようにします。 |
| StartWorkspaceExtension | RemoteApp およびデスクトップ接続コントロール パネルを使用して、クライアントのリモート セッションを調整します。 |
プロパティ
MsRdpClient12 クラスには、これらのプロパティがあります。
| プロパティ | アクセスの種類 | 説明 |
|---|---|---|
|
AdvancedSettings |
読み取り専用 |
IMsTscAdvancedSettings インターフェイス ポインター。 |
|
AdvancedSettings2 |
読み取り専用 |
クライアント コントロールの詳細設定を設定するために使用 される IMsRdpClientAdvancedSettings インターフェイスへのポインター。 |
|
AdvancedSettings3 |
読み取り専用 |
クライアント コントロールの詳細設定を設定するために使用 される IMsRdpClientAdvancedSettings2 インターフェイスへのポインター。 |
|
AdvancedSettings4 |
読み取り専用 |
クライアント コントロールの詳細設定を設定するために使用 される IMsRdpClientAdvancedSettings3 インターフェイスへのポインター。 |
|
AdvancedSettings5 |
読み取り専用 |
IMsRdpClientAdvancedSettings4 インターフェイス ポインター。 |
|
AdvancedSettings6 |
読み取り専用 |
IMsRdpClientAdvancedSettings5 へのインターフェイス。 |
|
AdvancedSettings7 |
読み取り専用 |
IMsRdpClientAdvancedSettings6 へのインターフェイス。 |
|
AdvancedSettings8 |
読み取り専用 |
IMsRdpClientAdvancedSettings7 インターフェイスをサポートする オブジェクト。 |
|
AdvancedSettings9 |
読み取り専用 |
設定オブジェクトを表す IMsRdpClientAdvancedSettings8 インターフェイス。 |
|
AllowCredentialSaving |
読み取り/書き込み |
資格情報の保存を有効にするチェック ボックスを資格情報ダイアログ ボックスに表示するかどうかを指定します。 |
|
AllowPromptingForCredentials |
読み取り/書き込み |
リモート デスクトップ ActiveX コントロールがユーザーに資格情報の入力を求めることができるかどうかを指定します。 |
|
BinaryPassword |
読み取り/書き込み |
このプロパティはサポートされていません。 |
|
BinarySalt |
読み取り/書き込み |
このプロパティはサポートされていません。 |
|
CipherStrength |
読み取り専用 |
現在のコントロールの最大暗号化強度。 |
|
ClearTextPassword |
書き込み専用 |
リモート デスクトップの ActiveX コントロール パスワード (プレーンテキスト形式)。 |
|
ColorDepth |
読み取り/書き込み |
現在のコントロールの色深度。 |
|
接続済み |
読み取り専用 |
現在のコントロールの接続状態。 |
|
ConnectedStatusText |
読み取り/書き込み |
コントロールが接続状態の間にコントロールのクライアント領域に表示されるテキスト。 |
|
ConnectingText |
読み取り/書き込み |
コントロールの接続中にコントロールの中央に表示されるテキスト。 |
|
ConnectionBarText |
読み取り/書き込み |
接続バーに表示するテキスト文字列。 |
|
DesktopHeight |
読み取り/書き込み |
初期リモート デスクトップ上の現在のコントロールの高さ (ピクセル単位)。 |
|
DesktopWidth |
読み取り/書き込み |
初期リモート デスクトップ上の現在のコントロールの幅 (ピクセル単位)。 |
|
DeviceCollection |
読み取り専用 |
リダイレクトに使用できる PnP デバイスのコレクション。 |
|
DisableConnectionBar |
書き込み専用 |
リモート デスクトップ ActiveX コントロールで接続バーを無効にするかどうかを指定します。 |
|
DisableRemoteAppCapsCheck |
読み取り/書き込み |
RemoteApp 機能用にリモート デスクトップ ActiveX コントロールがサーバーをチェックしないようにするかどうかを指定します。 |
|
DisconnectedText |
読み取り/書き込み |
接続が終了する前にコントロールの中央に表示されるテキスト。 |
|
Domain |
読み取り/書き込み |
現在のユーザーがログオンするドメイン。 |
|
DriveCollection |
読み取り専用 |
リダイレクトに使用できるディスク ドライブのコレクション。 |
|
EnableCredSspSupport |
読み取り/書き込み |
この接続に対して CredSSP を有効にするかどうかを指定します。 |
|
ExtendedDisconnectReason |
読み取り専用 |
クライアント コントロールの切断の理由に関する拡張情報。 |
|
フルスクリーン |
読み取り/書き込み |
コントロールが全画面表示モードであるかどうかを示します。 |
|
FullScreenTitle |
書き込み専用 |
コントロールが全画面表示モードのときに表示されるウィンドウ タイトル。 |
|
GetRemoteMonitorsBoundingBox |
読み取り専用 |
リモート モニターの外接する四角形を指定します。 |
|
HorizontalScrollBarVisible |
読み取り専用 |
コントロールに水平スクロール バーが表示されているかどうかを示します。 |
|
LaunchedViaClientShellInterface |
読み取り/書き込み |
ユーザーが RD Web Access インターフェイスを使用してクライアント コントロールを起動したかどうかを指定します。 |
|
MarkRdpSettingsSecure |
読み取り/書き込み |
RDP 設定をセキュリティで保護されたとしてマークするかどうかを指定します。 |
|
MsRdpClientShell |
読み取り専用 |
Web ポータル起動ツールのクライアント設定。 |
|
NegotiateSecurityLayer |
読み取り/書き込み |
この接続に対して NegotiateSecurityLayer 設定をサポートするかどうかを指定します。 メモ：CredSspSupport が有効でクライアント上に存在する場合、またはユーザー認証で Secure Sockets Layer (SSL) が有効になっている場合、NegotiateSecurityLayer は無視されます。 |
|
PortablePassword |
読み取り/書き込み |
このプロパティはサポートされていません。 |
|
PortableSalt |
読み取り/書き込み |
このプロパティはサポートされていません。 |
|
PromptForCredentials |
読み取り/書き込み |
資格情報の入力を求めるダイアログ ボックスを表示するかどうかを指定します。 |
|
PromptForCredsOnClient |
読み取り/書き込み |
資格情報の入力を求めるダイアログ ボックスをクライアント コントロールに表示するかどうかを指定します。 |
|
PublisherCertificateChain |
読み取り/書き込み |
発行元証明書チェーンを指定します。 チェーンは、 CERT_CHAIN_CONTEXT構造体への ポインターを含むVT_BYREF型のバリアントに格納されます。 |
|
RedirectDynamicDevices |
読み取り/書き込み |
セッション中に列挙される動的にアタッチされた PnP デバイスをリダイレクトに使用できるかどうかを指定します。 |
|
RedirectDynamicDrives |
読み取り/書き込み |
セッション中に列挙される動的に接続された PnP ドライブをリダイレクトに使用できるかどうかを指定します。 |
|
RedirectionWarningType |
読み取り/書き込み |
リダイレクト ダイアログ ボックスの存在と外観を制御します。 |
|
RemoteMonitorCount |
読み取り専用 |
リモート モニターの数を指定します。 |
|
RemoteMonitorLayoutMatchesLocal |
読み取り専用 |
リモート モニター レイアウトがローカル モニター レイアウトと同じかどうかを指定します。 |
|
RemoteProgram |
読み取り専用 |
クライアント RemoteApp の設定。 |
|
RemoteProgram2 |
読み取り専用 |
ITSRemoteProgram2 インターフェイスをサポートする オブジェクト。 |
|
RemoteProgram3 |
読み取り専用 |
ITSRemoteProgram3 インターフェイスをサポートする オブジェクト。 |
|
SecuredSettings |
読み取り専用 |
IMsTscSecuredSettings インターフェイス ポインター。 |
|
SecuredSettings2 |
読み取り専用 |
クライアント コントロールのセキュリティで保護された設定を設定するために使用される 、IMsRdpClientSecuredSettings インターフェイスへのポインター。 |
|
SecuredSettings3 |
読み取り専用 |
IMsRdpClientSecuredSettings2 インターフェイスをサポートする オブジェクト。 |
|
SecuredSettingsEnabled |
読み取り専用 |
IMsTscSecuredSettings インターフェイスを使用できるかどうかを示します。 |
|
Server |
読み取り/書き込み |
現在のコントロールが接続されているサーバーの名前。 |
|
ShowRedirectionWarningDialog |
読み取り/書き込み |
セッションを開始する前に、リダイレクト セキュリティの警告ダイアログ ボックスを表示するかどうかを指定します。 |
|
StartConnected |
読み取り/書き込み |
コントロールが起動時に RD セッション ホスト サーバー接続をすぐに確立するかどうかを示します。 |
|
TransportSettings |
読み取り専用 |
クライアント RD ゲートウェイの設定。 |
|
TransportSettings2 |
読み取り専用 |
IMsRdpClientTransportSettings2 へのインターフェイス。 |
|
TransportSettings3 |
読み取り専用 |
IMsRdpClientTransportSettings3 インターフェイスをサポートする オブジェクト。 |
|
TransportSettings4 |
読み取り専用 |
IMsRdpClientTransportSettings4 インターフェイスをサポートする オブジェクト。 |
|
TrustedZoneSite |
読み取り/書き込み |
ユーザーが接続を開始した Web サイトが、クライアント コンピューターの信頼済みサイトの一覧に含まれるかどうかを指定します。 |
|
UIParentWindowHandle |
読み取り/書き込み |
コントロールの親ウィンドウとなるウィンドウ ハンドル。 これにより、コントロールによって表示されるすべてのウィンドウが、親アプリケーションによって表示されるウィンドウに対して適切にモーダルになります。 |
|
UseMultimon |
読み取り/書き込み |
リモート デスクトップ ActiveX コントロールで複数のモニターを使用するかどうかを指定します。 |
|
UseRedirectionServerName |
読み取り/書き込み |
リダイレクト サーバー名を使用するかどうか。 |
|
名 |
読み取り/書き込み |
ユーザー名ログオン資格情報。 |
|
Version |
読み取り専用 |
現在のコントロールのバージョン番号。 |
|
VerticalScrollBarVisible |
読み取り専用 |
コントロールに垂直スクロール バーを表示するかどうかを示します。 |
|
WarnAboutClipboardRedirection |
読み取り/書き込み |
セッションを開始する前に、クリップボードのリダイレクトに関する警告をセキュリティ警告ダイアログ ボックスに含めるかどうかを指定します。 |
|
WarnAboutDirectXRedirection |
読み取り/書き込み |
このプロパティは使用されません。 |
|
WarnAboutPrinterRedirection |
読み取り/書き込み |
セッションを開始する前に、リダイレクト ダイアログ ボックスにプリンターのリダイレクトに関するメッセージを表示するかどうかを指定します。 |
|
WarnAboutSendingCredentials |
読み取り/書き込み |
セッションを開始する前に、リモート サーバーへの資格情報の送信に関する警告をセキュリティ警告に含めるかどうかを指定します。 |
| CameraRedirConfigCollection | 読み取り専用 | リダイレクトに使用できるカメラ (および関連する構成) のコレクションを取得します。 |
| クリップボードのトピック | 読み取り専用 | 手動クリップボード同期が有効になっている場合に、ローカルクリップボードとリモートクリップボードの同期に使用されるクリップボード コントローラーを取得します。 |
| CorrelationId | 読み取り専用 | クライアントのリモート セッションを一意に識別する GUID を取得します。 |
| SupportsWorkspaceReconnect | 書き込み専用 | クライアントのリモート セッションが、再接続をサポートする RemoteApp コントロール パネルとデスクトップ接続コントロール パネルの接続の一部であることを、リモート デスクトップ ActiveX コントロールに通知します。 |
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 10 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2016 |
| タイプ ライブラリ |
|
| [DLL] |
|
| CLSID |
CLSID_MsRdpClient12は 945EE98E-B376-4EC2-B2E5-64C9410F93B7 として定義されています |