Network​Information Network​Information Network​Information Class

Returns an array of ConnectionProfile objects that match the filtering criteria defined by ConnectionProfileFilter.

public static IAsyncOperation<IVectorView<ConnectionProfile>> FindConnectionProfilesAsync(ConnectionProfileFilter pProfileFilter)public static IAsyncOperation<IVectorView<ConnectionProfile>> FindConnectionProfilesAsync(ConnectionProfileFilter pProfileFilter)Public Static Function FindConnectionProfilesAsync(pProfileFilter As ConnectionProfileFilter) As IAsyncOperation( Of IVectorViewConnectionProfile )

Attributes

RemoteAsyncAttribute

Gets a list of profiles for connections, active or otherwise, on the local machine.

public static IVectorView<ConnectionProfile> GetConnectionProfiles()public static IVectorView<ConnectionProfile> GetConnectionProfiles()Public Static Function GetConnectionProfiles() As IVectorView( Of ConnectionProfile )

Attributes

ContractVersionAttribute DualApiPartitionAttribute MarshalingBehaviorAttribute StaticAttribute StaticAttribute

Remarks

The following example demonstrates how to retrieve a ConnectionProfile. The function calls getConnectionProfiles to retrieve all available connections on a device and display using a list. Alternatively, your app can call getInternetConnectionProfile to retrieve the ConnectionProfile representing the connection currently used for Internet connectivity.

function DisplayConnectionProfileList() {
    var profileList = "";
    var ConnectionProfiles = networkInfo.getConnectionProfiles();
        if (ConnectionProfiles.length !== 0) {
            for (var i = 0; i < ConnectionProfiles.length; i++) {

                //Display Connection profile info for each profile by passing it
                                                                //to a function that accesses and displays the connection properties
                profileList += getConnectionProfileInfo(ConnectionProfiles[i]);
                profileList += "-------------------------\n\r";
            }
            mySample.displayStatus(profileList);
        }
        else {
            mySample.displayStatus("No profiles found");
        }
    }

    catch (e) {
        mySample.displayError("Exception Caught: " + e + "\n\r");
    }
}

For additional examples of how NetworkInformation class methods are implemented to retrieve connection profiles, see Quickstart: Retrieving network connection information.

Gets a list of host names associated with the local machine.

public static IVectorView<HostName> GetHostNames()public static IVectorView<HostName> GetHostNames()Public Static Function GetHostNames() As IVectorView( Of HostName )

Attributes

ContractVersionAttribute DualApiPartitionAttribute MarshalingBehaviorAttribute StaticAttribute StaticAttribute

Gets the connection profile associated with the internet connection currently used by the local machine.

public static ConnectionProfile GetInternetConnectionProfile()public static ConnectionProfile GetInternetConnectionProfile()Public Static Function GetInternetConnectionProfile() As ConnectionProfile

Attributes

ContractVersionAttribute DualApiPartitionAttribute MarshalingBehaviorAttribute StaticAttribute StaticAttribute

Remarks

To be notified of changes in connectivity, register a handler with the NetworkStatusChanged event. When a notification is received of a network status change, call the GetInternetConnectionProfile method to get the current connection profile which can then be stored for later use when needed.

The following example demonstrates how to retrieve a ConnectionProfile. The function calls getInternetConnectionProfile to retrieve the ConnectionProfile representing the connection currently used for Internet connectivity. Alternatively, your app can call getConnectionProfiles to retrieve all available connections on a device.

var networkInfo = Windows.Networking.Connectivity.NetworkInformation;

//Retrieve the ConnectionProfile
var internetConnectionProfile = networkInfo.getInternetConnectionProfile();

//Pass the returned object to a function that accesses the connection data  
var connectionProfileInfo = getConnectionProfileInfo(internetConnectionProfile);

using namespace Windows::Networking::Connectivity;

//Retrieve the ConnectionProfile
ConnectionProfile^ InternetConnectionProfile = NetworkInformation::GetInternetConnectionProfile();

//Pass the returned object to a function that accesses the connection data        
String^ strConnectionProfileInfo = GetConnectionProfileInfo(InternetConnectionProfile);

using Windows.Networking.Connectivity;

//Retrieve the ConnectionProfile
string connectionProfileInfo = string.Empty;
ConnectionProfile InternetConnectionProfile = NetworkInformation.GetInternetConnectionProfile();

//Pass the returned object to a function that accesses the connection data  
connectionProfileInfo = GetConnectionProfileInfo(InternetConnectionProfile);

If more than one connection profile is currently connecting the machine to the internet, the preferred profile is returned by this method. The preferred profile represents the connection that is the most likely to be used when sending and receiving traffic to and from the internet.

For additional examples of how NetworkInformation class methods are implemented to retrieve connection profiles, see Quickstart: Retrieving network connection information.

Gets an array of LanIdentifier objects that contain locality information for each NetworkAdapter object that currently connected to a network.

public static IVectorView<LanIdentifier> GetLanIdentifiers()public static IVectorView<LanIdentifier> GetLanIdentifiers()Public Static Function GetLanIdentifiers() As IVectorView( Of LanIdentifier )

Attributes

ContractVersionAttribute DualApiPartitionAttribute MarshalingBehaviorAttribute StaticAttribute StaticAttribute

Remarks

For examples of how to retrieve LanIdentifier objects and access the information they represent, see How to retrieve network adapter and locality information.

Gets proxy configuration for a connection using the specified URI.

public static IAsyncOperation<ProxyConfiguration> GetProxyConfigurationAsync(Uri uri)public static IAsyncOperation<ProxyConfiguration> GetProxyConfigurationAsync(Uri uri)Public Static Function GetProxyConfigurationAsync(uri As Uri) As IAsyncOperation( Of ProxyConfiguration )

Attributes

RemoteAsyncAttribute

Remarks

The uri parameter passed to the GetProxyConfigurationAsync method should contain a hostname or IP address for the target endpoint and service name, port number, or protocol scheme.

If the GetProxyConfigurationAsync method is successful, a ProxyConfiguration object for the specified uri parameter is returned by the IAsyncOperation(ProxyConfiguration) handler.

In a Windows Store app, the StreamSocket class supports connecting to a remote endpoint when proxies are required to complete the connection. This support for proxies is automatic and transparent to the app. For more detailed information, see the remarks on Support for proxies in the StreamSocket class reference.

Gets a sorted list of EndpointPair objects.

public static IVectorView<EndpointPair> GetSortedEndpointPairs(IIterable<EndpointPair> destinationList, HostNameSortOptions sortOptions)public static IVectorView<EndpointPair> GetSortedEndpointPairs(IIterable<EndpointPair> destinationList, HostNameSortOptions sortOptions)Public Static Function GetSortedEndpointPairs(destinationList As IIterable<EndpointPair>, sortOptions As HostNameSortOptions) As IVectorView( Of EndpointPair )

Attributes

ContractVersionAttribute DualApiPartitionAttribute MarshalingBehaviorAttribute StaticAttribute StaticAttribute

Occurs when the network status changes for a connection.

public static event NetworkStatusChangedEventHandler NetworkStatusChangedpublic static event NetworkStatusChangedEventHandler NetworkStatusChangedPublic Static Event NetworkStatusChanged

Attributes

ContractVersionAttribute DualApiPartitionAttribute MarshalingBehaviorAttribute StaticAttribute StaticAttribute