Метод 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 |
Библиотека типов |
|
DLL |
|
IID |
IID_IMsRdpClientNonScriptable определяется как 2f079c4c-87b2-4afd-97ab-20cdb43038ae |