This topic has not yet been rated - Rate this topic

IMsRdpClient::RequestClose method

Requests a graceful shutdown of the Remote Desktop ActiveX control. A graceful shutdown can include ending the user's Remote Desktop Services session but it does not shut down the Remote Desktop Session Host (RD Session Host) server.

Syntax

C++


HRESULT RequestClose(
  [out]  ControlCloseStatus *pCloseStatus
);

Parameters

pCloseStatus [out]

Indicates whether the application can close the control immediately. Following is a list of possible values.

Value	Meaning
controlCloseCanProceed 0x0000	The container application can proceed to close the control immediately. This value can also indicate that the connection has already terminated.
controlCloseWaitForEvents 0x0001	The container application should not close the control immediately; the application should wait for one of the events described in the following Remarks section to occur before closing.

Return value

Return S_OK if successful.

Remarks

If the pCloseStatus parameter is equal to controlCloseWaitForEvents, the application should wait for one of the following events to occur before the application closes the control:

IMsTscAxEvents::OnDisconnected. If the user is not logged on to the Remote Desktop Services session, the application can call the DestroyWindow function to destroy all windows and then close the control.
IMsTscAxEvents::OnConfirmClose. If the user is logged on to the Remote Desktop Services session, the control fires an OnConfirmClose event. This event allows the application to prompt the user about whether to close the connection. If the user replies yes to the prompt, the container application can call DestroyWindow to destroy all windows, and close the control.

RequestClose allows a container application to prompt the user about whether to close a connection. For more information, see IMsTscAxEvents::OnConfirmClose.

For more information about Remote Desktop Web Connection, see Requirements for Remote Desktop Web Connection.

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
IID	IID_IMsRdpClient is defined as 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

Community Additions

ADD