Método IMsRdpClient::RequestClose

  • Artículo

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
MsTscAx.dll
Archivo DLL
MsTscAx.dll
IID
 IID_IMsRdpClient se define como 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

Consulte también

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

IMsTscAxEvents::OnConfirmClose

IMsTscAxEvents::OnDisconnected