IMsRdpClient::RequestClose メソッド

リモートデスクトップ ActiveX コントロールの正常なシャットダウンを要求します。正常なシャットダウンには、ユーザーのリモートデスクトップサービスセッションの終了を含めることができますが、リモートデスクトップセッションホスト (RD セッションホスト) サーバーはシャットダウンされません。

構文

HRESULT RequestClose(
  [out] ControlCloseStatus *pCloseStatus
);

pCloseStatus [out]: アプリケーションがコントロールを直ちに閉じることができるかどうかを示す ControlCloseStatus 列挙の値。使用可能な値の一覧を次に示します。
controlCloseCanProceed (0x0000): コンテナーアプリケーションは、すぐにコントロールを閉じ続けることができます。この値は、接続が既に終了したことを示すこともできます。
controlCloseWaitForEvents (0x0001): コンテナーアプリケーションは、コントロールを直ちに閉じてはいけません。アプリケーションは、閉じる前に、次の「備考」セクションで説明されているいずれかのイベントが発生するまで待機する必要があります。

成功 した場合は、S_OK を返します。

pCloseStatus パラメーターが controlCloseWaitForEvents と等しい場合、アプリケーションは、アプリケーションがコントロールを閉じる前に、次のいずれかのイベントが発生するまで待機する必要があります。

IMsTscAxEvents::OnDisconnected。ユーザーがリモートデスクトップサービスセッションにログオンしていない場合、アプリケーションは DestroyWindow 関数を呼び出してすべてのウィンドウを破棄し、コントロールを閉じます。
IMsTscAxEvents::OnConfirmClose。ユーザーがリモートデスクトップサービスセッションにログオンしている場合、コントロールは OnConfirmClose イベントを発生させます。このイベントにより、アプリケーションは接続を閉じるかどうかをユーザーに確認できます。ユーザーがプロンプトに [はい] と応答した場合、コンテナーアプリケーションは DestroyWindow を呼び出してすべてのウィンドウを破棄し、コントロールを閉じます。

RequestClose を使用すると、コンテナーアプリケーションは接続を閉じるかどうかをユーザーに確認できます。詳細については、「 IMsTscAxEvents::OnConfirmClose」を参照してください。

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

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
タイプライブラリ	MsTscAx.dll
[DLL]	MsTscAx.dll
IID	IID_IMsRdpClientは 92b4a539-7115-4b7c-a5a9-e5d9efc2780a として定義されています