NetworkInformation.GetInternetConnectionProfile Método

Definição

Namespace:

Windows.Networking.Connectivity

Recupera o perfil de conexão associado à interface preferencial usada atualmente pelo computador local. A interface preferencial é a mais provável de enviar ou receber tráfego da Internet. Isso significa que o perfil retornado pode ou não ter acesso à Internet.

public:
 static ConnectionProfile ^ GetInternetConnectionProfile();

 static ConnectionProfile GetInternetConnectionProfile();

public static ConnectionProfile GetInternetConnectionProfile();

function getInternetConnectionProfile()

Public Shared Function GetInternetConnectionProfile () As ConnectionProfile

Retornos

ConnectionProfile

O perfil de conexão associado à interface preferencial ou nulo se não houver nenhum perfil de conexão com uma conexão adequada.

Comentários

Para ser notificado sobre alterações na conectividade, registre um manipulador com o evento NetworkStatusChanged . Quando uma notificação é recebida de uma rede status alteração, chame o método GetInternetConnectionProfile para obter o perfil de conexão atual, que pode ser armazenado para uso posterior, quando necessário.

O exemplo a seguir demonstra como recuperar um ConnectionProfile. A função chama GetInternetConnectionProfile para recuperar o ConnectionProfile que representa a conexão atualmente mais provavelmente usada para conectividade com a Internet. Como alternativa, seu aplicativo pode chamar GetConnectionProfiles para recuperar todas as conexões disponíveis em um dispositivo.

Observação

Para a implementação do método GetConnectionProfileInfo no código abaixo e para obter exemplos adicionais de como os métodos de classe NetworkInformation são implementados para recuperar perfis de conexão, consulte Início Rápido: Recuperando informações de conexão de rede.

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 mais de um perfil de conexão estiver conectando o computador à Internet no momento, o perfil preferencial será retornado por esse método. O perfil preferencial representa a conexão que é a mais provável de ser usada ao enviar e receber tráfego de e para a Internet.