Метод IMsRdpClient::RequestClose

Статья
06/13/2023

Запрашивает корректное завершение работы элемента ActiveX удаленного рабочего стола. Корректное завершение работы может включать завершение сеанса служб удаленных рабочих столов пользователя, но не приводит к завершению работы сервера узла сеансов удаленных рабочих столов (узла сеансов удаленных рабочих столов).

Синтаксис

HRESULT RequestClose(
  [out] ControlCloseStatus *pCloseStatus
);

Параметры

pCloseStatus [out]: Значение из перечисления ControlCloseStatus , указывающее, может ли приложение немедленно закрыть элемент управления. Ниже приведен список возможных значений.
controlCloseCanProceed (0x0000): Приложение-контейнер может немедленно закрыть элемент управления. Это значение также может указывать на то, что подключение уже завершено.
controlCloseWaitForEvents (0x0001): Контейнерное приложение не должно закрывать элемент управления немедленно; приложение должно ожидать, пока не произойдет одно из событий, описанных в следующем разделе Примечания, перед закрытием.

Возвращаемое значение

В случае успешного выполнения верните S_OK .

IMsTscAxEvents::OnDisconnected. Если пользователь не вошел в сеанс служб удаленных рабочих столов, приложение может вызвать функцию DestroyWindow , чтобы уничтожить все окна, а затем закрыть элемент управления.
IMsTscAxEvents::OnConfirmClose. Если пользователь вошел в сеанс служб удаленных рабочих столов, элемент управления вызывает событие OnConfirmClose . Это событие позволяет приложению запрашивать у пользователя, следует ли закрыть подключение. Если пользователь ответит "да" на запрос, приложение-контейнер может вызвать DestroyWindow , чтобы уничтожить все окна и закрыть элемент управления.

RequestClose позволяет приложению-контейнеру запрашивать у пользователя, следует ли закрыть подключение. Дополнительные сведения см. в разделе IMsTscAxEvents::OnConfirmClose.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Библиотека типов	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsRdpClient определяется как 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

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

IMsRdpClient
IMsRdpClient2
IMsRdpClient3
IMsRdpClient4
IMsRdpClient5
IMsRdpClient6
IMsRdpClient7
IMsRdpClient8
IMsRdpClient9
IMsRdpClient10
IMsTscAxEvents::OnConfirmClose
IMsTscAxEvents::OnDisconnected