Método IMsRdpClient::RequestClose
Solicita un apagado correcto del control ActiveX de Escritorio remoto. Un apagado correcto puede incluir finalizar la sesión de Servicios de Escritorio remoto del usuario, pero no apaga el servidor host de sesión de Escritorio remoto (host de sesión de Escritorio remoto).
Sintaxis
HRESULT RequestClose(
[out] ControlCloseStatus *pCloseStatus
);
Parámetros
-
pCloseStatus [out]
-
Valor de la enumeración ControlCloseStatus que indica si la aplicación puede cerrar el control inmediatamente. A continuación se muestra una lista de valores posibles.
-
controlCloseCanProceed (0x0000)
-
La aplicación contenedora puede continuar para cerrar el control inmediatamente. Este valor también puede indicar que la conexión ya ha finalizado.
-
controlCloseWaitForEvents (0x0001)
-
La aplicación contenedora no debe cerrar el control inmediatamente; La aplicación debe esperar a que se produzcan uno de los eventos descritos en la sección Comentarios siguientes antes de cerrarse.
Valor devuelto
Devuelve S_OK si se ejecuta correctamente.
Comentarios
Si el parámetro pCloseStatus es igual a controlCloseWaitForEvents, la aplicación debe esperar a que se produzca uno de los siguientes eventos antes de que la aplicación cierre el control:
- IMsTscAxEvents::OnDisconnected. Si el usuario no ha iniciado sesión en la sesión de Servicios de Escritorio remoto, la aplicación puede llamar a la función DestroyWindow para destruir todas las ventanas y, a continuación, cerrar el control.
- IMsTscAxEvents::OnConfirmClose. Si el usuario ha iniciado sesión en la sesión de Servicios de Escritorio remoto, el control desencadena un evento OnConfirmClose . Este evento permite a la aplicación preguntar al usuario sobre si se cierra la conexión. Si el usuario responde sí al símbolo del sistema, la aplicación contenedora puede llamar a DestroyWindow para destruir todas las ventanas y cerrar el control.
RequestClose permite que una aplicación contenedora solicite al usuario si desea cerrar una conexión. Para obtener más información, vea IMsTscAxEvents::OnConfirmClose.
Para obtener más información sobre la conexión web de Escritorio remoto, consulte Requisitos para la conexión web de Escritorio remoto.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Biblioteca de tipos |
|
| Archivo DLL |
|
| IID |
IID_IMsRdpClient se define como 92b4a539-7115-4b7c-a5a9-e5d9efc2780a |