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

Network computer picker control

, 15 Jul 2004
Rate this:
Please Sign up or sign in to vote.
A Windows class library for selecting networked computers.

Introduction

A Windows class library for selecting networked computers.

Background

While having authored several Windows Forms apps, I've frequently needed to browse the network specifically for selecting a computer, however there is no managed method to accomplish this. I was inspired by Michael Potter's Finding SQL Servers on the Network article, so I decided to take it a little further and allow more granular control of the types of computers one can select.

Enumerating Computers

The first thing we have to do is define the function which will perform this task for us. NetServerEnum is located in the NetApi32.dll library.

// enumerates network computers
[DllImport("Netapi32", CharSet=CharSet.Unicode)]
private static extern int NetServerEnum( 
    string servername,        // must be null
    int level,        // 100 or 101
    out IntPtr bufptr,        // pointer to buffer receiving data
    int prefmaxlen,        // max length of returned data
    out int entriesread,    // num entries read
    out int totalentries,    // total servers + workstations
    uint servertype,        // server type filter
    [MarshalAs(UnmanagedType.LPWStr)]
    string domain,        // domain to enumerate
    IntPtr resume_handle );

The third parameter of NetServerEnum will populate a structure containing information about the computers it finds. With the exception of sv101_platform_id & sv101_type, these values are exposed as public properties in the NetworkComputers struct.

// Holds computer information
[StructLayoutAttribute(LayoutKind.Sequential, CharSet=CharSet.Unicode)]
internal struct SERVER_INFO_101
{
    public int sv101_platform_id;
    public string sv101_name;
    public int sv101_version_major;
    public int sv101_version_minor;
    public int sv101_type;
    public string sv101_comment;
}

To get our list, we simply call one of the CompEnum constructors and pass it one of the ServerType values

ce = new CompEnum(CompEnum.ServerType.SV_TYPE_DOMAIN_CTRL | 
  CompEnum.ServerType.SV_TYPE_MASTER_BROWSER)
or it's equivalent bit-mapped value (GetServerTypeValues performs this step for us)
private void GetServerTypeValues(object sender, System.EventArgs e)
{
    int filterVal = 0x00;
    bool itemsChecked = false;
    foreach (CheckBox cb in groupBoxServerTypes.Controls)
    {
        if (cb.Checked)
        {
            filterVal += Int32.Parse((string)cb.Tag,
                System.Globalization.NumberStyles.HexNumber);
            itemsChecked = true;
        }
    }

    checkBoxAll.Enabled = !itemsChecked;
    DisplayComputerTypes((uint)filterVal);
}

Now we can enumerate through our collection of computers.

internal void DisplayComputerTypes(uint serverType)
{             
    Cursor.Current = Cursors.WaitCursor;
    lbComputers.Items.Clear();
    ce = new CompEnum(serverType, cbDomainList.SelectedItem.ToString());
    int numServer = ce.Length;
    
    if (ce.LastError.Length == 0)
    {
        IEnumerator enumerator = ce.GetEnumerator();

        int i = 0;
        while (enumerator.MoveNext())
        {
            lbComputers.Items.Add(ce[i].Name);
            i++;
        }
    }
...

Enumerating SQL Servers Using SQL-DMO

Short for SQL Server Distributed Management Objects, SQL-DMO is a far more reliable way to retrieve the names of SQL Servers on your network. My code first performs a check to see if SQL-DMO is possible, otherwise it uses the regular NetServerEnum API.

private void GetSqlServersUsingSQLDMO(object sender, System.EventArgs e)
{
    SQLDMO.Application app = new SQLDMO.ApplicationClass();
    SQLDMO.NameList nameList = app.ListAvailableSQLServers();
    string srvName = "";
    _sqlServerList = new string[nameList.Count];

    for (int i=0; i<nameList.Count; i++)
    {                
        srvName = nameList.Item(i + 1);
        _sqlServerList[i] = srvName;
    }
}

ListAvailableSQLServers() returns a NameList object that enumerates SQL Server names. From here we use the Item method of NameList to retrieve the actual server name. That's all there is to it.

Sample Usage

CompPicker cp = new CompPicker();

// show selected computer
if (cp.ShowDialog(this) == DialogResult.OK)
    MessageBox.Show(this, cp.SelectedComputerName);

Extending

To extend the library to fit your needs, simply add or remove checkboxes in the groupBoxServerTypes group box and place their tag values equal to one of the ServerType bitmap values. These values are originally defined in LMServer.h and can also be found in the CompEnum class.

Performance Issues

Performance is hampered in a non-domain environment, presumably because there is no browse master defined? The same holds true when browsing in a different domain than the one you are currently in.

Compatibility

Since the NetServerEnum WinAPI is only available for Windows NT or greater, it will not work on Win9x machines.

History

  • Version 1.0 - 06.01.2004 - First release version.
  • Version 1.1 - 07.15.2004 - Utilize SQL-DMO for enumerating SQL Servers, if available.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

Marc Merritt
Architect
United States United States
I live in southeastern Pennsylvania, USA with my lovely wife and two beautiful daughters. Life is good. My hobbies are motorcycles, motorcycles, and motorcycles.
 
I run a riders group called Twisties Motorcycle Club. If you're are a rider in the tri-state area, look us up! http://twistiesmc.com/
Follow on   Twitter

Comments and Discussions

 
QuestionIs it depend on Win 7 Computer browser service? Pinmemberchenthooran1-Mar-13 0:32 
GeneralWorks the first couple of times then no computers are returned. Pinmemberpipipip8-Dec-09 13:38 
QuestionGet computer IP address PinmemberRadu_2020-Apr-08 5:03 
GeneralRe: Get computer IP address PinmemberMarc Merritt22-Apr-08 7:35 
QuestionGetSqlServersUsingSQLDMO return only one Computer PinmemberUmer Khan30-Sep-07 21:48 
AnswerRe: GetSqlServersUsingSQLDMO return only one Computer PinmemberMarc Merritt1-Oct-07 15:08 
QuestionRe: GetSqlServersUsingSQLDMO return only one Computer PinmemberUmer Khan2-Oct-07 5:43 
GeneralError 6118 Pinmembertkotia13-Mar-07 10:11 
GeneralRe: Error 6118 PinmemberMarc Merritt28-Jun-07 16:26 
GeneralThank you very much for this article PinmemberH. S. Masud7-May-06 3:22 
GeneralRe: Thank you very much for this article PinmemberMarc Merritt7-May-06 14:58 
GeneralThank you Pinmembershawn_b4-Mar-06 17:33 
GeneralOh, it's perfect PinmemberTastoEsc24-Jan-06 23:20 
GeneralThanks PinmemberBret Williams4-May-05 5:17 
GeneralAn SQLDMO exception PinmemberRandyY11-Jan-05 16:32 
QuestionCan I implement This program in WinCE PinmemberThe illiterate29-Oct-04 20:15 
AnswerRe: Can I implement This program in WinCE PinmemberMarc Merritt5-Nov-04 2:29 
Generalcan't see xp computers Pinmemberchoiceplus27-Oct-04 10:10 
GeneralRe: can't see xp computers PinmemberMarc Merritt5-Nov-04 2:21 
GeneralRe: can't see xp computers Pinmemberchoiceplus5-Nov-04 3:00 
GeneralIt has unhandled exceptions Pinmemberjrpally30-Jun-04 9:35 
GeneralRe: It has unhandled exceptions PinmemberMarc Merritt1-Jul-04 10:25 
Generalnice PinmemberVladimir Ralev9-Jun-04 10:59 
GeneralLarge Domains Pinmembernetclectic7-Jun-04 23:52 
GeneralRe: Large Domains PinmemberMarc Merritt8-Jun-04 2:17 

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 | Mobile
Web01 | 2.8.140709.1 | Last Updated 16 Jul 2004
Article Copyright 2004 by Marc Merritt
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid