IPGlobalProperties.HostName Property

Definition

Gets the host name for the local computer.

public:
 abstract property System::String ^ HostName { System::String ^ get(); };
public abstract string HostName { get; }
member this.HostName : string
Public MustOverride ReadOnly Property HostName As String

Property Value

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

Exceptions

A Win32 function call failed.

Examples

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

Remarks

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.

Applies to