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.
-
Windows 8/Windows Server 2012
-
200 minimum, 8192 maximum
-
Windows 7/Windows Server 2008
-
200 minimum, 2048 maximum
-
Windows Vista
-
200 minimum, 1200 maximum
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
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Type library |
|
| DLL |
|
| IID |
IID_IMsTscAx is defined as 8C11EFAE-92C3-11D1-BC1E-00C04FA31489 |