Udostępnij za pośrednictwem

Funkcja Networking_GetInterfaces

  • Artykuł

Nagłówek: #include <applibs/networking.h>

Pobiera listę interfejsów sieciowych na urządzeniu Azure Sphere. Jeśli outNetworkInterfaces jest zbyt mała, aby pomieścić wszystkie interfejsy sieciowe w systemie, ta funkcja wypełnia tablicę i zwraca liczbę elementów tablicy. Liczba interfejsów w systemie nie zmieni się w cyklu rozruchu.

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

Parametry

  • outNetworkInterfacesArray Wskaźnik do tablicy Networking_NetworkInterface struktur do wypełnienia właściwościami interfejsu sieciowego. Wywołujący musi przydzielić pamięć do tablicy po wywołaniu Networking_GetInterfacesCount , aby pobrać liczbę interfejsów na urządzeniu.

  • networkInterfacesArrayCount Liczba elementów outNetworkInterfacesArray , które można przechowywać. Tablica powinna mieć jeden element dla każdego interfejsu sieciowego na urządzeniu.

Błędy

Zwraca wartość -1 w przypadku napotkania błędu i ustawia errno wartość błędu.

  • EFAULT: outNetworkInterfacesArray parametr ma wartość NULL.

  • ERANGE: networkInterfacesArrayCount parmaeter ma wartość 0.

  • EAGAIN: stos sieci nie jest jeszcze gotowy.

Mogą być również określone inne errno błędy; takie błędy nie są deterministyczne i to samo zachowanie może nie być zachowane za pośrednictwem aktualizacji systemu.

Zwracana wartość

Zwraca liczbę interfejsów sieciowych dodanych do tablicy outNetworkInterfaces . W przeciwnym razie -1 dla niepowodzenia, w którym to przypadku errno jest ustawiona wartość błędu.

Pojęcia i próbki