Dela via

funktionen Networking_GetInterfaces

  • Artikel

Sidhuvud: #include <applibs/networking.h>

Hämtar listan över nätverksgränssnitt i en Azure Sphere-enhet. Om outNetworkInterfaces den här funktionen är för liten för att innehålla alla nätverksgränssnitt i systemet fylls matrisen och antalet matriselement returneras. Antalet gränssnitt i systemet ändras inte inom en startcykel.

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

Parametrar

  • outNetworkInterfacesArray En pekare till en matris med Networking_NetworkInterface strukturer som ska fyllas med nätverksgränssnittsegenskaper. Uppringaren måste allokera minnet för matrisen när Networking_GetInterfacesCount anropas för att hämta antalet gränssnitt på enheten.

  • networkInterfacesArrayCount Antalet element outNetworkInterfacesArray kan innehålla. Matrisen ska ha ett element för varje nätverksgränssnitt på enheten.

Fel

Returnerar -1 om ett fel uppstår och anger errno felvärdet.

  • EFAULT: parametern outNetworkInterfacesArray är NULL.

  • ERANGE: networkInterfacesArrayCount parmaetern är 0.

  • EAGAIN: nätverksstacken är inte klar än.

errno Andra kan också anges, sådana fel är inte deterministiska och samma beteende kanske inte behålls via systemuppdateringar.

Returvärde

Returnerar antalet nätverksgränssnitt som lagts till i matrisen outNetworkInterfaces . Annars -1 för fel, i vilket fall errno är inställt på felvärdet.

Koncept och exempel