NetworkInformation.GetConnectionProfiles | getConnectionProfiles Method

Obtiene una lista de perfiles para las conexiones establecidas, activas o no, actualmente en el equipo local.

Sintaxis


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

Parámetros

Este Método no tiene parámetros.

Valor devuelto

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

Una matriz de objetos ConnectionProfile.

Comentarios

En el ejemplo de código siguiente se muestra cómo recuperar una clase ConnectionProfile. La función llama a getConnectionProfiles para recuperar todas las conexiones disponibles en un dispositivo y mostrarlas mediante una lista. O bien, la aplicación puede llamar a getInternetConnectionProfile para recuperar el ConnectionProfile que representa la conexión utilizada actualmente para la conectividad de Internet.


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

Para obtener más ejemplos de cómo se implementan los métodos de la clase NetworkInformation para recuperar perfiles de conexión, vea Inicio rápido: recuperar información de la conexión de red.

Windows Phone 8

Esta API no se implementa y producirá una excepción si se llama. Vea API Runtime de Windows Phone.

Requisitos

Cliente mínimo admitido

Windows 8

Servidor mínimo admitido

Windows Server 2012

Teléfono mínimo admitido

Windows Phone 8 [no implementado, vea los comentarios]

Espacio de nombres

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

Metadatos

Windows.winmd

Vea también

NetworkInformation

 

 

Mostrar:
© 2015 Microsoft