IMsRdpClientNonScriptable::NotifyRedirectDeviceChange method

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.

ValueMeaning
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

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Type library

Mstscax.dll

DLL

Mstscax.dll

IID

IID_IMsRdpClientNonScriptable is defined as 2f079c4c-87b2-4afd-97ab-20cdb43038ae

See also

IMsRdpClientNonScriptable2
IMsRdpClientNonScriptable3
IMsRdpClientNonScriptable

 

 

Show:
© 2014 Microsoft