Partage via

Networking_GetInterfaces, fonction

  • Article

En-tête : #include <applibs/networking.h>

Obtient la liste des interfaces réseau dans un appareil Azure Sphere. Si outNetworkInterfaces est trop petit pour contenir toutes les interfaces réseau du système, cette fonction remplit le tableau et retourne le nombre d’éléments du tableau. Le nombre d’interfaces dans le système ne change pas au cours d’un cycle de démarrage.

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

Paramètres

  • outNetworkInterfacesArray Pointeur vers un tableau de structs Networking_NetworkInterface à remplir avec les propriétés de l’interface réseau. L’appelant doit allouer de la mémoire pour le tableau après avoir appelé Networking_GetInterfacesCount pour récupérer le nombre d’interfaces sur l’appareil.

  • networkInterfacesArrayCount Nombre d’éléments outNetworkInterfacesArray pouvant contenir. Le tableau doit avoir un élément pour chaque interface réseau sur l’appareil.

Erreurs

Retourne -1 si une erreur est rencontrée et définit errno sur la valeur d’erreur.

  • EFAULT : le outNetworkInterfacesArray paramètre est NULL.

  • ERANGE : le networkInterfacesArrayCount parmaeter est 0.

  • EAGAIN : la pile réseau n’est pas encore prête.

Toutes les autres errno peuvent également être spécifiées ; ces erreurs ne sont pas déterministes et le même comportement peut ne pas être conservé par le biais des mises à jour système.

Valeur de retour

Retourne le nombre d’interfaces réseau ajoutées au outNetworkInterfaces tableau. Sinon, -1 en cas d’échec, auquel cas errno est défini sur la valeur d’erreur.

Concepts et exemples