IPv4InterfaceProperties Class

.NET Framework (current version)

Other Versions

Provides information about network interfaces that support Internet Protocol version 4 (IPv4).

Namespace: System.Net.NetworkInformation
Assembly: System (in System.dll)

Inheritance Hierarchy

System::Object
System.Net.NetworkInformation::IPv4InterfaceProperties

Syntax

C++

public ref class IPv4InterfaceProperties abstract

Constructors

	Name	Description
	IPv4InterfaceProperties()	Initializes a new instance of the IPv4InterfaceProperties class.

Properties

	Name	Description
	Index	Gets the index of the network interface associated with the Internet Protocol version 4 (IPv4) address.
	IsAutomaticPrivateAddressingActive	Gets a Boolean value that indicates whether this interface has an automatic private IP addressing (APIPA) address.
	IsAutomaticPrivateAddressingEnabled	Gets a Boolean value that indicates whether this interface has automatic private IP addressing (APIPA) enabled.
	IsDhcpEnabled	Gets a Boolean value that indicates whether the interface is configured to use a Dynamic Host Configuration Protocol (DHCP) server to obtain an IP address.
	IsForwardingEnabled	Gets a Boolean value that indicates whether this interface can forward (route) packets.
	Mtu	Gets the maximum transmission unit (MTU) for this network interface.
	UsesWins	Gets a Boolean value that indicates whether an interface uses Windows Internet Name Service (WINS).

Methods

	Name	Description
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	Finalize()	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	ToString()	Returns a string that represents the current object.(Inherited from Object.)

This class provides access to configuration and address information for network interfaces that support IPv4. You do not create instances of this class; they are returned by the GetIPv4Properties method.

For IPV6 properties, see GetIPv6Properties.

Examples

The following code example gets an GetIPv4Properties object and displays its data.

C++

void DisplayIPv4NetworkInterfaces()
{
   array<NetworkInterface^>^nics = NetworkInterface::GetAllNetworkInterfaces();
   IPGlobalProperties ^ properties = IPGlobalProperties::GetIPGlobalProperties();
   Console::WriteLine( "IPv4 interface information for {0}.{1}", properties->HostName, properties->DomainName );
   System::Collections::IEnumerator^ myEnum23 = nics->GetEnumerator();
   while ( myEnum23->MoveNext() )
   {
      NetworkInterface ^ adapter = safe_cast<NetworkInterface ^>(myEnum23->Current);

      // Only display informatin for interfaces that support IPv4.
      if ( adapter->Supports( NetworkInterfaceComponent::IPv4 ) == false )
      {
         continue;
      }
      Console::WriteLine();
      Console::WriteLine( adapter->Description );

      // Underline the description.
      Console::WriteLine( String::Empty->PadLeft( adapter->Description->Length, '=' ) );
      IPInterfaceProperties ^ adapterProperties = adapter->GetIPProperties();

      // Try to get the IPv4 interface properties.
      IPv4InterfaceProperties ^ p = adapterProperties->GetIPv4Properties();
      if ( !p )
      {
         Console::WriteLine( "No IPv4 information is available for this interface." );
         continue;
      }

      // Display the IPv4 specific data.
      Console::WriteLine( "  Index ............................. : {0}", 
         p->Index );
      Console::WriteLine( "  MTU ............................... : {0}", 
         p->Mtu );
      Console::WriteLine( "  APIPA active....................... : {0}", 
         p->IsAutomaticPrivateAddressingActive );
      Console::WriteLine( "  APIPA enabled...................... : {0}", 
         p->IsAutomaticPrivateAddressingEnabled );
      Console::WriteLine( "  Forwarding enabled................. : {0}", 
         p->IsForwardingEnabled );
      Console::WriteLine( "  Uses WINS ......................... : {0}", 
         p->UsesWins );
   }
}

Version Information

.NET Framework
Available since 2.0

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.