Метод IMsRdpClient::RequestClose
Запрашивает корректное завершение работы элемента ActiveX удаленного рабочего стола. Корректное завершение работы может включать завершение сеанса служб удаленных рабочих столов пользователя, но не приводит к завершению работы сервера узла сеансов удаленных рабочих столов (узла сеансов удаленных рабочих столов).
Синтаксис
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.
Дополнительные сведения о веб-подключении к удаленному рабочему столу см. в разделе Требования к веб-подключению к удаленному рабочему столу.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Библиотека типов |
|
| DLL |
|
| IID |
IID_IMsRdpClient определяется как 92b4a539-7115-4b7c-a5a9-e5d9efc2780a |