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

How to obtain the current TCP/IP configuation for all adapters

, 18 Aug 2003
Rate this:
Please Sign up or sign in to vote.
An article on obtaining the current TCP/IP configuration for all .NET supported OSs.

Introduction

Obtaining the current TCP/IP configuration, is not provided by the standard .NET class libraries. In order to work on all the standard desktop OSs supported by .NET, at least two different approaches must be taken. For more recent OSs such as Windows XP, WMI contains objects that can be queried to obtain this information. The System.Management namespace provides access to WMI objects in managed code. For older OSs like Windows 98, an entirely different approach is needed. Since running the .NET Framework on Windows 98 also requires Internet Explorer 5.x or higher we can also assume that the library IPHLPAPI.DLL is available. This library commonly called IPHelper provides the API calls needed to obtain network configuration. Since IPHLPAPI is not managed code, a managed code wrapper needs to be created to use the .NET Interop services to invoke IPHLPAPI routines.

Using the code

The source code project provides two classes. The primary class is called NetworkConfiguration. NetworkConfiguration makes the determination internally regarding whether to use WMI or IPHLPAPI.DLL. It provides public methods such as GetTCPIPSettings() that returns an ArrayList of AdapterTCPIPSettings instances. AdapterSettings contains the basic configuration data such as the adapter description, IP addresses, subnets, and gateways. There are several other methods in NetworkConfiguration that serve as helper functions to obtain very task specific information from GetTCPIPSettings(). GetDNSServers() is one such method.

The second class is the managed code wrapper that calls into several APIs from IPHLPAPI.DLL. It is used internally by NetworkConfiguration only for OSs that do not support WMI. This class can also be used outside of NetworkConfiguration, if needed.

An example of using NetworkConfiguration is provided in the downloadable example attached to this article. The following code snippet demonstrates enumerating through the adapters and doing something with its members.

using MooseNet;
...

ArrayList settings = NetworkConfiguration.GetTCPIPSettings();
foreach ( NetworkConfiguration.AdapterTCPIPSettings setting in settings ) 
{ 
    if ( setting._description != null )
    {
        ...
    }
    ...
}

Points of interest

Something to keep in mind is that the WMI query can be rather slow. Do not call GetTCPIPSettings() very often in your code. The helper methods in NetworkConfiguration use a caching mechanism to avoid this. Another thing is that the AdapterSettings instances will frequently contain null references for data that can not be obtained. This should be checked before using any of its values.

You will also notice that these classes are part of a namespace called MooseNet. MooseNet is my open source networking library written in C#. Please check out my project page at http://www.hypermoose.com. You will find many useful classes for handling protocols such as UPnP, SMTP, POP3 and DNS there.

History

  • Initial version - August 10, 2003

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

About the Author

Gary Caldwell
Web Developer
United States United States
No Biography provided

Comments and Discussions

 
Generalhypermoose.com PinmemberRamon Smits3-Jan-07 23:14 
GeneralRe: hypermoose.com Pinmemberjohn_172610-Jun-14 10:40 
GeneralRe: hypermoose.com Pinmemberjohn_172617-Jun-14 11:51 
QuestionPorting to PocketPC Pinmemberddellarossa8-Feb-06 23:00 
GeneralSetTcpEntry Function PinmemberVitoto16-May-05 4:39 
QuestionWMI? Pinmemberbouli26-Oct-04 0:57 
AnswerRe: WMI? PinmemberVitoto19-May-05 5:38 
GeneralRemote adapter info Pinmemberserberwww13-Sep-04 21:53 
GeneralRe: Remote adapter info PinmemberPrasadGVL10-Oct-04 23:59 
GeneralWill this work for Non-Admin Logins Pinmembertanveerakl22-Aug-04 20:49 

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
Web02 | 2.8.140709.1 | Last Updated 19 Aug 2003
Article Copyright 2003 by Gary Caldwell
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid