Share via

IMsRdpClientNonScriptable::NotifyRedirectDeviceChange (Windows CE 5.0)

  • Article

Send Feedback

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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.