NetworkInformation.GetInternetConnectionProfile 方法

定义

命名空间:

Windows.Networking.Connectivity

检索与本地计算机当前使用 的首选 接口关联的连接配置文件。 首选接口是最有可能发送或接收 Internet 流量的接口。 这意味着返回的配置文件可能具有 Internet 访问权限，也可能无法访问 Internet。

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 ，该连接表示当前最有可能用于 Internet 连接的连接。 或者，应用可以调用 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);

如果当前有多个连接配置文件将计算机连接到 Internet，则此方法将返回首选配置文件。 首选配置文件表示在发送和接收来自 Internet 的流量时最有可能使用的连接。