Método IMsRdpClient::RequestClose
Solicita um desligamento normal do controle ActiveX da Área de Trabalho Remota. Um desligamento normal pode incluir o fim da sessão dos Serviços de Área de Trabalho Remota do usuário, mas não desliga o servidor host de sessão de área de trabalho remota (Host de Sessão de Área de Trabalho Remota).
Sintaxe
HRESULT RequestClose(
[out] ControlCloseStatus *pCloseStatus
);
Parâmetros
-
pCloseStatus [out]
-
Valor da enumeração ControlCloseStatus que indica se o aplicativo pode fechar o controle imediatamente. A seguir está uma lista de valores possíveis.
-
controlCloseCanProceed (0x0000)
-
O aplicativo de contêiner pode continuar a fechar o controle imediatamente. Esse valor também pode indicar que a conexão já foi encerrada.
-
controlCloseWaitForEvents (0x0001)
-
O aplicativo de contêiner não deve fechar o controle imediatamente; o aplicativo deve aguardar que um dos eventos descritos na seção Comentários a seguir ocorra antes de fechar.
Valor retornado
Retorne S_OK se tiver êxito.
Comentários
Se o parâmetro pCloseStatus for igual a controlCloseWaitForEvents, o aplicativo deverá aguardar que um dos seguintes eventos ocorra antes que o aplicativo feche o controle:
- IMsTscAxEvents::OnDisconnected. Se o usuário não estiver conectado à sessão de Serviços de Área de Trabalho Remota, o aplicativo poderá chamar a função DestroyWindow para destruir todas as janelas e, em seguida, fechar o controle.
- IMsTscAxEvents::OnConfirmClose. Se o usuário estiver conectado à sessão de Serviços de Área de Trabalho Remota, o controle disparará um evento OnConfirmClose . Esse evento permite que o aplicativo solicite ao usuário se deseja fechar a conexão. Se o usuário responder sim ao prompt, o aplicativo de contêiner poderá chamar DestroyWindow para destruir todas as janelas e fechar o controle.
RequestClose permite que um aplicativo de contêiner solicite ao usuário se deseja fechar uma conexão. Para obter mais informações, consulte IMsTscAxEvents::OnConfirmClose.
Para obter mais informações sobre a Conexão da Web da Área de Trabalho Remota, consulte Requisitos para conexão da Web da Área de Trabalho Remota.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Biblioteca de tipos |
|
| DLL |
|
| IID |
IID_IMsRdpClient é definido como 92b4a539-7115-4b7c-a5a9-e5d9efc2780a |