IMsRdpClient::RequestClose 方法

请求正常关闭远程桌面 ActiveX 控件。 正常关闭可能包括结束用户的远程桌面服务会话,但它不会关闭远程桌面会话主机 (RD 会话主机) 服务器。

语法

HRESULT RequestClose(
  [out] ControlCloseStatus *pCloseStatus
);

parameters

pCloseStatus [out]

ControlCloseStatus 枚举中的值,指示应用程序是否可以立即关闭控件。 下面是可能值的列表。

controlCloseCanProceed (0x0000)

容器应用程序可以继续立即关闭控件。 此值还可以指示连接已终止。

controlCloseWaitForEvents (0x0001)

容器应用程序不应立即关闭控件;应用程序应在关闭之前等待以下“备注”部分中所述的事件之一发生。

返回值

如果成功,则返回 S_OK

备注

如果 pCloseStatus 参数等于 controlCloseWaitForEvents,则应用程序应在应用程序关闭控件之前等待以下事件之一发生:

  • IMsTscAxEvents::OnDisconnected。 如果用户未登录到远程桌面服务会话,应用程序可以调用 DestroyWindow 函数来销毁所有窗口,然后关闭控件。
  • IMsTscAxEvents::OnConfirmClose。 如果用户登录到远程桌面服务会话,则控件将触发 OnConfirmClose 事件。 此事件允许应用程序提示用户是否关闭连接。 如果用户对提示回复是,容器应用程序可以调用 DestroyWindow 来销毁所有窗口,并关闭控件。

RequestClose 允许容器应用程序提示用户是否关闭连接。 有关详细信息,请参阅 IMsTscAxEvents::OnConfirmClose

有关远程桌面 Web 连接的详细信息,请参阅 远程桌面 Web 连接的要求

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
类型库
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID_IMsRdpClient定义为 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

另请参阅

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

IMsTscAxEvents::OnConfirmClose

IMsTscAxEvents::OnDisconnected