NetworkInformation.GetInternetConnectionProfile Metodo

Definizione

Spazio dei nomi:

Windows.Networking.Connectivity

Recupera il profilo di connessione associato all'interfaccia preferita attualmente usata dal computer locale. L'interfaccia preferita è quella più probabile per inviare o ricevere traffico Internet. Ciò significa che il profilo restituito potrebbe o non avere accesso a Internet.

public:
 static ConnectionProfile ^ GetInternetConnectionProfile();

 static ConnectionProfile GetInternetConnectionProfile();

public static ConnectionProfile GetInternetConnectionProfile();

function getInternetConnectionProfile()

Public Shared Function GetInternetConnectionProfile () As ConnectionProfile

Restituisce

ConnectionProfile

Profilo di connessione associato all'interfaccia preferita o Null se non è presente alcun profilo di connessione con una connessione appropriata.

Commenti

Per ricevere una notifica delle modifiche apportate alla connettività, registrare un gestore con l'evento NetworkStatusChanged . Quando viene ricevuta una notifica di modifica dello stato di rete, chiamare il metodo GetInternetConnectionProfile per ottenere il profilo di connessione corrente che può quindi essere archiviato per un uso successivo quando necessario.

Nell'esempio seguente viene illustrato come recuperare un ConnectionProfile. La funzione chiama GetInternetConnectionProfile per recuperare il ConnectionProfile che rappresenta la connessione attualmente attualmente usata per la connettività Internet. In alternativa, l'app può chiamare GetConnectionProfiles per recuperare tutte le connessioni disponibili in un dispositivo.

Nota

Per l'implementazione del metodo GetConnectionProfileInfo nel codice seguente e per altri esempi del modo in cui i metodi della classe NetworkInformation vengono implementati per recuperare i profili di connessione, vedere Avvio rapido: Recupero delle informazioni di connessione di rete.

using Windows.Networking.Connectivity;

// Retrieve the ConnectionProfile.
ConnectionProfile internetConnectionProfile = NetworkInformation.GetInternetConnectionProfile();

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

#include <winrt/Windows.Networking.Connectivity.h>
using namespace winrt;

std::wstring GetConnectionProfileInfo(Windows::Networking::Connectivity::ConnectionProfile const& connectionProfile)
{
    ...
}

int main()
{
    winrt::init_apartment();

    // Retrieve the ConnectionProfile.
    auto internetConnectionProfile{ Windows::Networking::Connectivity::NetworkInformation::GetInternetConnectionProfile() };

    // Pass the returned object to a function that accesses the connection data.
    std::wstring strConnectionProfileInfo{ 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);

Se più di un profilo di connessione sta attualmente connettendo il computer a Internet, il profilo preferito viene restituito da questo metodo. Il profilo preferito rappresenta la connessione che è la più probabile da usare durante l'invio e la ricezione del traffico da e verso Internet.