NetworkInformation.GetInternetConnectionProfile Метод

Определение

Пространство имен:

Windows.Networking.Connectivity

Извлекает профиль подключения, связанный с предпочитаемым интерфейсом, который в настоящее время используется локальным компьютером. Предпочтительный интерфейс является наиболее вероятным для отправки или получения интернет-трафика. Это означает, что возвращенный профиль может иметь доступ к Интернету или от него.

public:
 static ConnectionProfile ^ GetInternetConnectionProfile();

 static ConnectionProfile GetInternetConnectionProfile();

public static ConnectionProfile GetInternetConnectionProfile();

function getInternetConnectionProfile()

Public Shared Function GetInternetConnectionProfile () As ConnectionProfile

Возвращаемое значение

ConnectionProfile

Профиль подключения, связанный с предпочитаемым интерфейсом, или значение NULL , если нет профиля подключения с подходящим подключением.

Комментарии

Чтобы получать уведомления об изменениях в подключении, зарегистрируйте обработчик с помощью события NetworkStatusChanged . При получении уведомления об изменении состояния сети вызовите метод GetInternetConnectionProfile , чтобы получить текущий профиль подключения, который затем можно сохранить для последующего использования при необходимости.

В следующем примере показано, как получить ConnectionProfile. Функция вызывает GetInternetConnectionProfile , чтобы получить ConnectionProfile , представляющий подключение, которое в настоящее время, скорее всего, используется для подключения к Интернету. Кроме того, приложение может вызывать GetConnectionProfiles , чтобы получить все доступные подключения на устройстве.

Примечание

Сведения о реализации метода GetConnectionProfileInfo в приведенном ниже коде, а также дополнительные примеры реализации методов класса NetworkInformation для извлечения профилей подключений см. в статье Краткое руководство. Получение сведений о сетевом подключении.

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

Если в настоящее время несколько профилей подключения подключают компьютер к Интернету, этот метод возвращает предпочтительный профиль. Предпочтительный профиль представляет подключение, которое, скорее всего, будет использоваться при отправке и получении трафика в Интернет и из Интернета.