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

Confira também

Imsrdpclient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

IMsTscAxEvents::OnConfirmClose

IMsTscAxEvents::OnDisconnected