NetworkInformation.GetInternetConnectionProfile Méthode

Définition

Espace de noms:

Windows.Networking.Connectivity

Récupère le profil de connexion associé à l’interface préférée actuellement utilisée par l’ordinateur local. L’interface préférée est celle qui est la plus susceptible d’envoyer ou de recevoir du trafic Internet. Cela signifie que le profil retourné peut avoir ou non accès à Internet.

public:
 static ConnectionProfile ^ GetInternetConnectionProfile();

 static ConnectionProfile GetInternetConnectionProfile();

public static ConnectionProfile GetInternetConnectionProfile();

function getInternetConnectionProfile()

Public Shared Function GetInternetConnectionProfile () As ConnectionProfile

Retours

ConnectionProfile

Profil de connexion associé à l’interface par défaut , ou null s’il n’existe aucun profil de connexion avec une connexion appropriée.

Remarques

Pour être informé des modifications apportées à la connectivité, inscrivez un gestionnaire avec l’événement NetworkStatusChanged . Lorsque vous recevez une notification d’une modification de status réseau, appelez la méthode GetInternetConnectionProfile pour obtenir le profil de connexion actuel, qui peut ensuite être stocké pour une utilisation ultérieure si nécessaire.

L’exemple suivant montre comment récupérer un ConnectionProfile. La fonction appelle GetInternetConnectionProfile pour récupérer le connectionProfile représentant la connexion la plus susceptible d’être utilisée pour la connectivité Internet. Votre application peut également appeler GetConnectionProfiles pour récupérer toutes les connexions disponibles sur un appareil.

Notes

Pour l’implémentation de la méthode GetConnectionProfileInfo dans le code ci-dessous et pour obtenir des exemples supplémentaires de la façon dont les méthodes de classe NetworkInformation sont implémentées pour récupérer des profils de connexion, consultez Démarrage rapide : Récupération des informations de connexion réseau.

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 plusieurs profils de connexion connectent actuellement l’ordinateur à Internet, le profil préféré est retourné par cette méthode. Le profil préféré représente la connexion la plus susceptible d’être utilisée lors de l’envoi et de la réception du trafic vers et depuis Internet.