Метод 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.

Дополнительные сведения о веб-подключении к удаленному рабочему столу см. в разделе Требования к веб-подключению к удаленному рабочему столу.

Требования

См. также раздел

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

IMsTscAxEvents::OnConfirmClose

IMsTscAxEvents::OnDisconnected