Configuring the connection

Top  Previous  Next

 

Besides the basic parameters required to establish the connection, you can send additional parameters to configure the connection the way you want.

Find below the list of parameters to configure the One-time-URL connection:

 

Parameter

What it means

Type/format

Default

username

The username to authenticate against the remote machine. If this parameter is not sent, ThinRDP will prompt the user for this information.

string

Username

 

password

The password to authenticate against the remote machine. If this parameter is not sent, ThinRDP will prompt the user for this information.

string

Password

 

startprg

If you will use the OneTimeURL to start a specific application, you should change this and the following three fields. Set it to 0 for "Do nothing" option; 1 for "Start a program" option; 2 for "Launch RemoteApp" option.

integer

0,1 or 2

0

command

Full remote application path that should start upon connection establishment.

string

app path

 

directory

Initial context directory to be used by the application set on command parameter described above.

string

dir path

 

cmdargs

Arguments to start the application specified on the "command" property.

string

app args

 

bpp

Color Depth: sets the number of bits per pixel. Set 8 for 256 colors; 15 for True Color (15 bit); 16 for True Color (16 bit) ; 24 for True Color (24 bit)

integer

8,15,16 or 24

 

16

resolution

"fittobrowser", "fittoscreen", "fixed", when fixed, the parameters width and height will be considered.

string

toolbar size

"fittobrowser"

width

Remote desktop screen width.

It will only be considered when the resolution parameter is set to "fixed".

integer

pixels

Desktop width

height

Remote desktop screen height.

It will only be considered when the resolution parameter is set to "fixed"

integer

pixels

Desktop height

imagequality

Specifies the image quality/compression. Set 0 for "Highest!; 1 for "Optimal"; 2 for "Good"; 3 for "Faster"

integer

0,1,2 or 3

1

desktopbackground

Set to true to show the original remote desktop background.

boolean

true,false

false

visualstyles

Set to true to change the start menu and other windows features style.

boolean

true,false

false

menuwindowanimation

Set to true to show an animation on the Star menu.

boolean

true,false

false

fontsmoothing

Set to true to make text easier to read, specially the magnified ones.

boolean

true,false

false

showwindowcontent

Set to true to show windows contents while dragging it.

boolean

true,false

false

desktopcomposition

Set to true to configure the DWM to redirected the desktop drawing to off-screen surfaces in video memory. The desktop will, also, present many  visual effects.

boolean

true,false

false

unicodekeyboard

Allows for using full unicode keyboard charsets. Set to false to connect to xRDP servers.

boolean

true,false

true

console

Forces the connection to the remote console session.

boolean

true,false

false

wscompression

Set to true to enable the compression for the exchanged Websocket data and have the application performance improved.

boolean

true,false

true

diskenabled

Set to true to have an intermediate disk available on the connection.

boolean

true,false

true

diskname

Identify the intermediate disk among the other remote desktop disks.

string

name

"ThinDisk"

diskautodownload

Set to true to automatically download any file saved/copied on the Intermediate disk.

boolean

true,false

true

 

note

 

To add each parameter to the queryString, concatenate an & symbol, the name of the parameter, the = symbol and the value for the parameter, following this format:

 

...&password=myPassword&resolution=fittobrowser...