NetworkInformation.GetInternetConnectionProfile Methode

Definition

Namespace:

Windows.Networking.Connectivity

Ruft das Verbindungsprofil ab, das der bevorzugten Schnittstelle zugeordnet ist, die derzeit vom lokalen Computer verwendet wird. Die bevorzugte Schnittstelle ist diejenige, die am wahrscheinlichsten Internetdatenverkehr sendet oder empfängt. Dies bedeutet, dass das zurückgegebene Profil möglicherweise über Internetzugriff verfügt oder nicht.

public:
 static ConnectionProfile ^ GetInternetConnectionProfile();

 static ConnectionProfile GetInternetConnectionProfile();

public static ConnectionProfile GetInternetConnectionProfile();

function getInternetConnectionProfile()

Public Shared Function GetInternetConnectionProfile () As ConnectionProfile

Gibt zurück

ConnectionProfile

Das der bevorzugten Schnittstelle zugeordnete Verbindungsprofil oder NULL , wenn kein Verbindungsprofil mit einer geeigneten Verbindung vorhanden ist.

Hinweise

Um über Änderungen an der Konnektivität benachrichtigt zu werden, registrieren Sie einen Handler beim NetworkStatusChanged-Ereignis . Wenn eine Benachrichtigung über eine Netzwerkänderung status empfangen wird, rufen Sie die GetInternetConnectionProfile-Methode auf, um das aktuelle Verbindungsprofil abzurufen, das bei Bedarf zur späteren Verwendung gespeichert werden kann.

Im folgenden Beispiel wird veranschaulicht, wie Ein ConnectionProfile abgerufen wird. Die Funktion ruft GetInternetConnectionProfile auf, um das ConnectionProfile abzurufen, das die derzeit wahrscheinlich für die Internetverbindung verwendete Verbindung darstellt. Alternativ kann Ihre App GetConnectionProfiles aufrufen, um alle verfügbaren Verbindungen auf einem Gerät abzurufen.

Hinweis

Informationen zur Implementierung der GetConnectionProfileInfo-Methode im folgenden Code und weitere Beispiele für die Implementierung von NetworkInformation-Klassenmethoden zum Abrufen von Verbindungsprofilen finden Sie unter Schnellstart: Abrufen von Netzwerkverbindungsinformationen.

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

Wenn derzeit mehrere Verbindungsprofile den Computer mit dem Internet verbinden, wird das bevorzugte Profil von dieser Methode zurückgegeben. Das bevorzugte Profil stellt die Verbindung dar, die am ehesten beim Senden und Empfangen von Datenverkehr zum und aus dem Internet verwendet wird.