Поделиться через


Метод IMsRdpClientNonScriptable::NotifyRedirectDeviceChange

Уведомляет модуль перенаправления устройств элемента 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