IMsTscAx::DesktopWidth property

Specifies the current control's width, in pixels, on the initial remote desktop.

This property is read/write.

Syntax


HRESULT put_DesktopWidth(
  [in]   LONG newVal
);

HRESULT get_DesktopWidth(
  [out]  LONG *pVal
);

Property value

The new width, in pixels.

Error codes

Return S_OK if successful.

Remarks

Setting the DesktopWidth property is optional, but it must be set before calling the Connect method. If a desktop width is not specified, or is set to zero, the desktop width is set to the width of the control. The minimum and maximum values are dependent upon the operating system version of the Remote Desktop client.

Remote Desktop client operating systemMinimum/maximum value
Windows 8/Windows Server 2012200/8192
Windows 7/Windows Server 2008200/2048
Windows Vista/Windows Server 2003/Windows XP200/1200

 

After a connection is established, any changes to the control's width do not change the width of the remote desktop. Instead, the control brings up scroll bars or centers the remote desktop, as appropriate. To change the desktop size of an active connection, use the IMsRdpClient8::Reconnect method.

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_IMsTscAx is defined as 8C11EFAE-92C3-11D1-BC1E-00C04FA31489

See also

IMsRdpClient
IMsRdpClient2
IMsRdpClient3
IMsRdpClient4
IMsRdpClient5
IMsRdpClient6
IMsRdpClient7
IMsRdpClient8
IMsTscAx

 

 

Show:
© 2014 Microsoft