NetworkInformation.GetConnectionProfiles | getConnectionProfiles Method

获取本地计算机上活动连接或其他连接的配置文件列表。

语法


var iVectorView = Windows.Networking.Connectivity.NetworkInformation.getConnectionProfiles();

参数

此 方法 没有参数。

返回值

类型: IVectorView<ConnectionProfile> [JavaScript/C++] | System.Collections.Generic.IReadOnlyList<ConnectionProfile> [.NET]

ConnectionProfile 对象的数组。

备注

下面的示例演示如何检索 ConnectionProfile。函数调用 getConnectionProfiles 检索设备上的所有可用连接并显示使用列表。或者,您的应用程序可以调用 getInternetConnectionProfile 以检索表示为 Internet 连接当前使用的连接的 ConnectionProfile


function DisplayConnectionProfileList() {
    var profileList = "";
    var ConnectionProfiles = networkInfo.getConnectionProfiles();
        if (ConnectionProfiles.length !== 0) {
            for (var i = 0; i < ConnectionProfiles.length; i++) {

                //Display Connection profile info for each profile by passing it
																//to a function that accesses and displays the connection properties
                profileList += getConnectionProfileInfo(ConnectionProfiles[i]);
                profileList += "-------------------------\n\r";
            }
            mySample.displayStatus(profileList);
        }
        else {
            mySample.displayStatus("No profiles found");
        }
    }

    catch (e) {
        mySample.displayError("Exception Caught: " + e + "\n\r");
    }
}

有关 NetworkInformation 类方法如何实现以检索连接配置方式,请参见快速入门:检索网络连接信息

Windows Phone 8

此 API 不实现,但是调用时会引发异常。请参见 Windows Phone 运行时 API

要求

最低支持客户端

Windows 8

最低支持服务器

Windows Server 2012

最低支持电话

Windows Phone 8 [未实现,请参见备注]

命名空间

Windows.Networking.Connectivity
Windows::Networking::Connectivity [C++]

元数据

Windows.winmd

另请参见

NetworkInformation

 

 

显示:
© 2014 Microsoft