Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IPGlobalProperties::BeginGetUnicastAddresses Method (AsyncCallback^, Object^)

.NET Framework (current version)
 

Begins an asynchronous request to retrieve the stable unicast IP address table on the local computer.

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

public:
virtual IAsyncResult^ BeginGetUnicastAddresses(
	AsyncCallback^ callback,
	Object^ state
)

Parameters

callback
Type: System::AsyncCallback^

The System::AsyncCallback delegate.

state
Type: System::Object^

An object that contains state information for this request.

Return Value

Type: System::IAsyncResult^

An System::IAsyncResult that references the asynchronous request.

Exception Condition
NotImplementedException

This method is not implemented on the platform. This method uses the native NotifyStableUnicastIpAddressTable function that is supported on Windows Vista and later.

Win32Exception

The call to the native NotifyStableUnicastIpAddressTable function failed.

In order to support outbound connections or to accept incoming connections on a Teredo interface, applications need to ensure that the Teredo interface is up and ready for use. This is because Teredo can go into a dormant state when not used for some period of time.

The BeginGetUnicastAddresses method allows an application to asynchronously retrieve the list of stable unicast IP addresses. The IPAddress::IsIPv6Teredo property can be used to determine if an IP address is an IPv6 Teredo address with the prefix of 2001::/32.

The BeginGetUnicastAddresses method also returns non-Teredo addresses and provides a more convenient way to obtain the unicast IP addresses for a system than enumerating all the System.Net.NetworkInformation::NetworkInterface objects on a local computer and querying the associated IP addresses.

.NET Framework
Available since 4.0
Return to top
Show:
© 2017 Microsoft