Compartir vía

Función Networking_GetInterfaces

  • Artículo

Encabezado: #include <applibs/networking.h>

Obtiene la lista de interfaces de red en un dispositivo Azure Sphere. Si outNetworkInterfaces es demasiado pequeña para contener todas las interfaces de red del sistema, esta función rellena la matriz y devuelve el número de elementos de la matriz. El número de interfaces en el sistema no cambiará dentro de un ciclo de arranque.

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

Parámetros

  • outNetworkInterfacesArray Puntero a una matriz de Networking_NetworkInterface estructuras para rellenar con propiedades de interfaz de red. El autor de la llamada debe asignar memoria para la matriz después de llamar a Networking_GetInterfacesCount para recuperar el número de interfaces en el dispositivo.

  • networkInterfacesArrayCount El número de elementos outNetworkInterfacesArray puede contener. La matriz debe tener un elemento para cada interfaz de red del dispositivo.

Errores

Devuelve -1 si se encuentra un error y se establece errno en el valor de error.

  • EFAULT: el outNetworkInterfacesArray parámetro es NULL.

  • ERANGE: el networkInterfacesArrayCount parmaeter es 0.

  • EAGAIN: la pila de redes aún no está lista.

También se pueden especificar otros errno errores; estos errores no son deterministas y es posible que no se conserve el mismo comportamiento a través de las actualizaciones del sistema.

Valor devuelto

Devuelve el número de interfaces de red agregadas a la outNetworkInterfaces matriz. En caso contrario, -1 para error, en cuyo caso errno se establece en el valor de error.

Conceptos y ejemplos