Click here to Skip to main content
Click here to Skip to main content

Remote Desktop Manager (MSTSCUI.NET)

, 7 Dec 2006
Rate this:
Please Sign up or sign in to vote.
Simply a graphical interface to Microsoft's command-line Remote Desktop Connection, mstsc.exe.

mstscui.net

Introduction

MSTSCUI.NET is simply a graphical interface to Microsoft's command-line Remote Desktop Connection, mstsc.exe. This application makes it easier for those who use Remote Desktop sessions often through the day. It uses the .NET Framework v1.1.

Some of the things this app demonstrates:

  • Reading a simple XML document
  • Creating a systray application
  • Dynamically populating a context menu

All in all, a very simple and useful little application.

General Use

top

MSTSCUI.NET runs as a taskbar application to allow quick and easy access to RDP servers:

taskbar

It's generally reccommended to place an entry in your startup group so that the application launches on startup.

Simply right-click on the taskbar icon to show the menu:

menu

Select "Edit List" for a shortcut to edit your server configuration file, and "Refresh List" to reload it.

MSTSCUI.NET.exe.config

top

Use the app.config file to set the name of the server configuration file with the "ServerConfigFile" key, and set your preferred editor with the "Editor" key. It's not recommended you change the "ServerConfigFile" key. The "Editor" key should be a fully qualified path if the editor you're using is not already setup in your path environment variables.

Below is the listing of the default app.config file:

<xmp>
<configuration>
    <appSettings>

        <!-- path to XML Server Configuration File -->
        <add key="ServerConfigFile" value="mstscui_servers.xml" />
        
        <!-- XML File Editor to use -->
        <add key="Editor" value="notepad" />

     </appSettings>
</configuration>
</xmp>

Server Configuration XML (mstscui_servers.xml)

top

Use the server configuration file to setup each server.

In order to display a horizontal separator bar on the menu, use:

<xmp>
    <server displayname="-" />
</xmp>

Each server element has an attribute called "displayname" - this is the name displayed on the menu. You can be as descriptive here as necessary.

  • servername - server name or IP address
  • port - default is 3389
  • resolution - "fullscreen", or any resolution entered in this fashion: 1024x728
  • console - 1 for yes, takeover console session, 0 for no, do not takeover console
  • connectionfile - fully qualified path to the RDP file if you want to use one

Below is the listing of a sample server config file:

<xmp>
<servers>

    <server displayname="eventvan02 / secure">
        <servername>eventvan02</servername>
        <port>3389</port>
        <resolution>1024x768</resolution>
        <console>0</console>
        <connectionfile></connectionfile>
    </server>

    <server displayname="-" />

    <server displayname="vancorpbc1">
        <servername>vancorpbc1</servername>
        <port>3389</port>
        <resolution>fullscreen</resolution>
        <console>0</console>
        <connectionfile></connectionfile>
    </server>

</servers>
</xmp>

Select Code Samples

top

Launching msctsc.exe...

Private Sub ConnectToServer(ByVal sServer As String)
    Try
        Dim sCommand As String = _
          System.Environment.GetEnvironmentVariable("SystemRoot") & _
          "\system32\mstsc.exe"
        System.Diagnostics.Process.Start(sCommand, _
               GetArgumentsForServer(sServer))
    Catch ex As Exception
        MessageBox.Show(ex.Message)
    End Try
End Sub

Reading the XML configuration file...

Private Function GetArgumentsForServer(ByVal sServer As String) As String

    Dim sConnection As String
    Dim sPort As String
    Dim sResolution As String
    Dim arrResolution() As String
    Dim sConsole As String
    Dim sConnectionFile As String

    Dim sArguments As String

    Dim parentnode As XmlNode = doc.SelectSingleNode("servers")
    Dim servernode As XmlNode = _
        SelectNode(parentnode, "displayname", sServer)
    Dim childnode As XmlNode

    For Each childnode In servernode.ChildNodes
        Select Case UCase(childnode.Name)
            Case "SERVERNAME"
                sConnection = " /v:" & Trim(childnode.InnerText)
            Case "PORT"
                If Trim(childnode.InnerText) <> "3389" And _
                        childnode.InnerText <> String.Empty Then
                    sPort = ":" & childnode.InnerText
                Else
                    sPort = String.Empty
                End If

            Case "RESOLUTION"
                If InStr(UCase(childnode.InnerText), "X") > 0 Then
                    arrResolution = Split(UCase(childnode.InnerText), "X")
                    sResolution = " /w:" & arrResolution(0) & _
                                  " /h:" & arrResolution(1)
                Else
                    'anything else, default to fullscreen
                    sResolution = " /f"
                End If
            Case "CONSOLE"
                If CBool(childnode.InnerText) Then
                    sConsole = " /console"
                Else
                    sConsole = String.Empty
                End If
            Case "CONNECTIONFILE"
                sConnectionFile = childnode.InnerText
            Case Else
                MessageBox.Show("Unrecognized node in XML: " & _
                                childnode.InnerText)
        End Select
    Next

    'build argument string
    sArguments = sConnection & sPort & sResolution & sConsole

    Return sArguments

End Function

Private Function SelectNode(ByVal parentNode As XmlNode, _
        ByVal attributeName As String, _
        ByVal attributeValue As String) As XmlNode
    Dim node As XmlNode = Nothing
    If parentNode.HasChildNodes Then
        Dim nodeName As String = parentNode.ChildNodes(0).Name
        Dim path As String = nodeName + "[@" + _
            attributeName + "='" + attributeValue + "']"
        node = parentNode.SelectSingleNode(path)
    End If
    Return node
End Function

History

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author


Comments and Discussions

 
GeneralTerrible code !!! PinmemberMember 436267631-Jan-09 18:41 
GeneralRe: Terrible code !!! PinmemberRay Cassick8-Aug-09 7:39 
GeneralRe: Terrible code !!! PinmemberMr President15-Sep-11 12:01 
GeneralMy vote of 1 PinmemberMember 436267631-Jan-09 18:14 
GeneralHi PinmemberVenkat8010-Nov-08 5:07 
GeneralRe: Hi PinmemberAnthony Collins10-Nov-08 5:21 
GeneralRe: Hi PinmemberVenkat8011-Nov-08 9:48 
Generalre:system requirements PinmemberRameshwerE6-Nov-07 3:19 
Could you give me the system specifications to run your application? Apart from .net FW. Will it works on windows 9x OS?
 
Thanks,

GeneralRe: re:system requirements PinmemberAnthony Collins6-Nov-07 4:00 
GeneralI am not able to run it PinmemberMe the Lover27-Dec-06 6:47 
GeneralRe: I am not able to run it PinmemberAnthony Collins28-Dec-06 10:04 
Jokehttp://famvir.ceroline.info/ Pinsusshttp://famvir.ceroline.info/4-Dec-07 23:30 
GeneralAlready existing Remote Desktop Manager Pinmemberdherv8-Dec-06 4:18 
GeneralRe: Already existing Remote Desktop Manager Pinmemberdotnetmcsd8-Dec-06 5:38 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.1411023.1 | Last Updated 7 Dec 2006
Article Copyright 2006 by Anthony Collins
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid