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 |
类型库 |
|
DLL |
|
IID |
IID_IMsRdpClient定义为 92b4a539-7115-4b7c-a5a9-e5d9efc2780a |