IMsRdpClientNonScriptable::NotifyRedirectDeviceChange (Windows CE 5.0)
This method notifies the device-redirection part of the Remote Desktop ActiveX control that a device change has occurred on the system. This method passes WM_DEVICECHANGE device messages to the control.
HRESULT NotifyRedirectDeviceChange(WPARAMwParam,LPARAM lParam);
Parameters
- wParam
[in] Specifies the device event. This parameter can be one of the values in the following table. - lParam
[in] Pointer to a structure that contains event-specific data. Its format depends on the value of wParam. The following table shows possible values for this parameter.Value Description 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 Windows 98, Windows Me, Windows 2000, or Windows XP 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 Windows 2000 or Windows XP system. DBT_QUERYCHANGECONFIG Permission is requested to change the current configuration (dock or undock). DBT_USERDEFINED The meaning of this message is user-defined.
Return Values
If the method succeeds, the return value is S_OK.
If it fails, the method returns a nonzero error code.
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.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Discodlg.h. Mstsax.idl.
Link Library: Mstsax.lib.
See Also
IMsRdpClientNonScriptable | IMsTscNonScriptable
Send Feedback on this topic to the authors