IMsRdpClientNonScriptable::NotifyRedirectDeviceChange method

Article
12/11/2020

Notifies the device redirection module of the Remote Desktop ActiveX control that a device change has occurred on the system. This method passes WM_DEVICECHANGE notifications to the control.

Syntax

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

Parameters

wParam [in]: Specifies the device event. This parameter can be one of the following values.
DBT_CONFIGCHANGECANCELED: A request to change the current configuration (dock or undock) has been canceled.
DBT_CONFIGCHANGED: The current configuration has changed due to a dock or undock.
DBT_CUSTOMEVENT: A custom event has occurred.
DBT_DEVICEARRIVAL: A device has been inserted and is now available.
DBT_DEVICEQUERYREMOVE: Permission is requested to remove a device. Any application can deny this request and cancel the removal.
DBT_DEVICEQUERYREMOVEFAILED: A request to remove a device has been canceled.
DBT_DEVICEREMOVECOMPLETE: A device has been removed.
DBT_DEVICEREMOVEPENDING: A device is about to be removed. The removal cannot be denied.
DBT_DEVICETYPESPECIFIC: A device-specific event has occurred.
DBT_DEVNODES_CHANGED: A device has been added to or removed from the system.
DBT_QUERYCHANGECONFIG: Permission is requested to change the current configuration (dock or undock).
DBT_USERDEFINED: The meaning of this message is user-defined.

lParam [in]

Pointer to a structure that contains event-specific data. Its format depends on the value of the wParam parameter. For more information, refer to the documentation for each event. For more information, see Device Event Types.

Return value

Return S_OK if successful.

Remarks

A container application that allows dynamic addition or removal of devices should process the WM_DEVICECHANGE message in its top level window and forward the message to the control using the NotifyRedirectDeviceChange method. An example of a dynamic device change is when a redirected disk drive is added or removed while the system is running.

For more information about Remote Desktop Web Connection, see Requirements for Remote Desktop Web Connection.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Type library	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsRdpClientNonScriptable is defined as 2f079c4c-87b2-4afd-97ab-20cdb43038ae