NetworkInformation.GetInternetConnectionProfile Método

Definición

Espacio de nombres:

Windows.Networking.Connectivity

Recupera el perfil de conexión asociado a la interfaz preferida usada actualmente por el equipo local. La interfaz preferida es la más probable que envíe o reciba tráfico de Internet. Esto significa que el perfil devuelto podría tener o no acceso a Internet.

public:
 static ConnectionProfile ^ GetInternetConnectionProfile();

 static ConnectionProfile GetInternetConnectionProfile();

public static ConnectionProfile GetInternetConnectionProfile();

function getInternetConnectionProfile()

Public Shared Function GetInternetConnectionProfile () As ConnectionProfile

Devoluciones

ConnectionProfile

El perfil de conexión asociado a la interfaz preferida o null si no hay ningún perfil de conexión con una conexión adecuada.

Comentarios

Para recibir una notificación de los cambios en la conectividad, registre un controlador con el evento NetworkStatusChanged . Cuando se recibe una notificación de un cambio de estado de red, llame al método GetInternetConnectionProfile para obtener el perfil de conexión actual que se puede almacenar para su uso posterior cuando sea necesario.

En el ejemplo siguiente se muestra cómo recuperar un objeto ConnectionProfile. La función llama a GetInternetConnectionProfile para recuperar connectionProfile que representa la conexión que probablemente se usa para la conectividad a Internet. Como alternativa, la aplicación puede llamar a GetConnectionProfiles para recuperar todas las conexiones disponibles en un dispositivo.

Nota

Para la implementación del método GetConnectionProfileInfo en el código siguiente y para obtener ejemplos adicionales de cómo se implementan los métodos de clase NetworkInformation para recuperar perfiles de conexión, consulte Inicio rápido: Recuperación de información de conexión de red.

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

Si más de un perfil de conexión está conectando actualmente la máquina a Internet, este método devuelve el perfil preferido. El perfil preferido representa la conexión que es más probable que se use al enviar y recibir tráfico hacia y desde Internet.