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
類型程式庫	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsRdpClient定義為 92b4a539-7115-4b7c-a5a9-e5d9efc2780a