IMsRdpClient：：RequestClose 方法
要求遠端桌面 ActiveX 控制項的正常關機。 正常關機可能包括結束使用者的遠端桌面服務會話，但不會關閉遠端桌面工作階段主機 (RD 工作階段主機) 伺服器。
語法
HRESULT RequestClose(
[out] ControlCloseStatus *pCloseStatus
);
參數
-
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 |