Click here to Skip to main content
15,499,571 members
Articles / Programming Languages / C#
Posted 6 Jun 2004


65 bookmarked

Network computer picker control

Rate me:
Please Sign up or sign in to vote.
4.65/5 (31 votes)
15 Jul 2004CPOL2 min read
A Windows class library for selecting networked computers.

Image 1


A Windows class library for selecting networked computers.


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
    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 | 
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,
            itemsChecked = true;

    checkBoxAll.Enabled = !itemsChecked;

Now we can enumerate through our collection of computers.

internal void DisplayComputerTypes(uint serverType)
    Cursor.Current = Cursors.WaitCursor;
    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())

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);


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.


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


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


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

Written By
Chief Technology Officer
Australia Australia
Living abroad and loving life.

Comments and Discussions

QuestionIs it depend on Win 7 Computer browser service? Pin
chenthooran1-Mar-13 1:32
Memberchenthooran1-Mar-13 1:32 
GeneralWorks the first couple of times then no computers are returned. Pin
pipipip8-Dec-09 14:38
Memberpipipip8-Dec-09 14:38 
QuestionGet computer IP address Pin
Radu_2020-Apr-08 6:03
MemberRadu_2020-Apr-08 6:03 
GeneralRe: Get computer IP address Pin
Christian Merritt22-Apr-08 8:35
MemberChristian Merritt22-Apr-08 8:35 
QuestionGetSqlServersUsingSQLDMO return only one Computer Pin
Umer Khan30-Sep-07 22:48
MemberUmer Khan30-Sep-07 22:48 
AnswerRe: GetSqlServersUsingSQLDMO return only one Computer Pin
Christian Merritt1-Oct-07 16:08
MemberChristian Merritt1-Oct-07 16:08 
QuestionRe: GetSqlServersUsingSQLDMO return only one Computer Pin
Umer Khan2-Oct-07 6:43
MemberUmer Khan2-Oct-07 6:43 
GeneralError 6118 Pin
tkotia13-Mar-07 11:11
Membertkotia13-Mar-07 11:11 
GeneralRe: Error 6118 Pin
Christian Merritt28-Jun-07 17:26
MemberChristian Merritt28-Jun-07 17:26 
GeneralThank you very much for this article Pin
H. S. Masud7-May-06 4:22
MemberH. S. Masud7-May-06 4:22 
Thanks for the article. I was looking for something like this. But later I realize that I needed some collection class which will contain the domains, computers and server in the network. So, I used your class to write my collection class. I think that that would be useful for others too. So, I have written a new article using your code and submited in codeproject. Here is the link of the article.


Hasan Shahriar Masud
Senior Software Engineer
Kaz Software limited
Dhaka, Bangladesh
GeneralRe: Thank you very much for this article Pin
Christian Merritt7-May-06 15:58
MemberChristian Merritt7-May-06 15:58 
GeneralThank you Pin
shawn_b4-Mar-06 18:33
Membershawn_b4-Mar-06 18:33 
GeneralOh, it's perfect Pin
Giovanni Tresoldi25-Jan-06 0:20
MemberGiovanni Tresoldi25-Jan-06 0:20 
GeneralThanks Pin
Bret Williams4-May-05 6:17
MemberBret Williams4-May-05 6:17 
GeneralAn SQLDMO exception Pin
RandyY11-Jan-05 17:32
MemberRandyY11-Jan-05 17:32 
QuestionCan I implement This program in WinCE Pin
The illiterate29-Oct-04 21:15
MemberThe illiterate29-Oct-04 21:15 
AnswerRe: Can I implement This program in WinCE Pin
Christian Merritt5-Nov-04 3:29
MemberChristian Merritt5-Nov-04 3:29 
Generalcan't see xp computers Pin
Michael Chao27-Oct-04 11:10
MemberMichael Chao27-Oct-04 11:10 
GeneralRe: can't see xp computers Pin
Christian Merritt5-Nov-04 3:21
MemberChristian Merritt5-Nov-04 3:21 
GeneralRe: can't see xp computers Pin
Michael Chao5-Nov-04 4:00
MemberMichael Chao5-Nov-04 4:00 
GeneralIt has unhandled exceptions Pin
jrpally30-Jun-04 10:35
Memberjrpally30-Jun-04 10:35 
GeneralRe: It has unhandled exceptions Pin
Christian Merritt1-Jul-04 11:25
MemberChristian Merritt1-Jul-04 11:25 
Generalnice Pin
Vladimir Ralev9-Jun-04 11:59
MemberVladimir Ralev9-Jun-04 11:59 
GeneralLarge Domains Pin
netclectic8-Jun-04 0:52
Membernetclectic8-Jun-04 0:52 
GeneralRe: Large Domains Pin
Christian Merritt8-Jun-04 3:17
MemberChristian Merritt8-Jun-04 3:17 

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

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