Метод IMsRdpClientNonScriptable::NotifyRedirectDeviceChange

Статья
06/13/2023

Уведомляет модуль перенаправления устройств элемента ActiveX удаленного рабочего стола о том, что в системе произошло изменение устройства. Этот метод передает WM_DEVICECHANGE уведомления элементу управления.

Синтаксис

HRESULT NotifyRedirectDeviceChange(
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

Параметры

wParam [in]: Указывает событие устройства. Этот параметр может принимать одно из указанных ниже значений.
DBT_CONFIGCHANGECANCELED: Запрос на изменение текущей конфигурации (док-станция или отстыковка) был отменен.
DBT_CONFIGCHANGED: Текущая конфигурация изменилась из-за док-станции или отстыковки.
DBT_CUSTOMEVENT: Произошло пользовательское событие.
DBT_DEVICEARRIVAL: Устройство вставлено и теперь доступно.
DBT_DEVICEQUERYREMOVE: Для удаления устройства запрашивается разрешение. Любое приложение может отклонить этот запрос и отменить удаление.
DBT_DEVICEQUERYREMOVEFAILED: Запрос на удаление устройства отменен.
DBT_DEVICEREMOVECOMPLETE: Устройство удалено.
DBT_DEVICEREMOVEPENDING: Устройство будет удалено. Невозможно запретить удаление.
DBT_DEVICETYPESPECIFIC: Произошло событие для конкретного устройства.
DBT_DEVNODES_CHANGED: Устройство добавлено в систему или удалено из нее.
DBT_QUERYCHANGECONFIG: Запрашивается разрешение на изменение текущей конфигурации (закрепления или отстыковки).
DBT_USERDEFINED: Это сообщение определяется пользователем.

lParam [in]

Указатель на структуру, содержащую данные, относящиеся к событиям. Его формат зависит от значения параметра wParam . Дополнительные сведения см. в документации по каждому событию. Дополнительные сведения см. в разделе Типы событий устройства.

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

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

Контейнерное приложение, позволяющее динамическое добавление или удаление устройств, должно обрабатывать сообщение WM_DEVICECHANGE в окне верхнего уровня и пересылать сообщение в элемент управления с помощью метода NotifyRedirectDeviceChange . Примером динамического изменения устройства является добавление или удаление перенаправленного диска во время работы системы.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Библиотека типов	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsRdpClientNonScriptable определяется как 2f079c4c-87b2-4afd-97ab-20cdb43038ae

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

IMsRdpClientNonScriptable2
IMsRdpClientNonScriptable3
IMsRdpClientNonScriptable4
IMsRdpClientNonScriptable5
IMsRdpClientNonScriptable