IMsRdpClientNonScriptable::NotifyRedirectDeviceChange (Windows Embedded CE 6.0)

1/6/2010

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.

Syntax

HRESULT NotifyRedirectDeviceChange(
  WPARAM wParam,
  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 Value

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

Header discodlg.h, mstsax.idl
Library Mstsax.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

IMsRdpClientNonScriptable
IMsTscNonScriptable