IPGlobalProperties::HostName Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets the host name for the local computer.

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

public:
property String^ HostName {
	virtual String^ get() abstract;
}

Property Value

Type: System::String^

A String instance that contains the computer's NetBIOS name.

Exception Condition
NetworkInformationException

A Win32 function call failed.

This property calls into the native IP Helper function, GetNetworkParams, which returns a FIXED_INFO structure that contains the NetBIOS host name string. The host name string is truncated when it exceeds 15 characters.

A computer's NetBIOS name must be unique within a network and is not fully qualified by the domain name.

The following code example displays network information for the local computer.

IPGlobalProperties ^ properties = IPGlobalProperties::GetIPGlobalProperties();
Console::WriteLine( "Computer name: {0}", properties->HostName );
Console::WriteLine( "Domain name:   {0}", properties->DomainName );
Console::WriteLine( "Node type:     {0:f}", properties->NodeType );
Console::WriteLine( "DHCP scope:    {0}", properties->DhcpScopeName );
Console::WriteLine( "WINS proxy?    {0}", properties->IsWinsProxy );

NetworkInformationPermission

for reading network information. Associated enumeration: Read.

.NET Framework
Available since 2.0
Return to top
Show: