Sdílet prostřednictvím

Networking_GetInterfaces funkce

  • Článek

Hlavička: #include <applibs/networking.h>

Získá seznam síťových rozhraní v zařízení Azure Sphere. Pokud outNetworkInterfaces je příliš malý na to, aby podržel všechna síťová rozhraní v systému, tato funkce vyplní pole a vrátí počet prvků matice. Počet rozhraní v systému se během spouštěcího cyklu nezmění.

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

Parametry

  • outNetworkInterfacesArray Ukazatel na pole Networking_NetworkInterface struktur, které vyplní vlastnosti síťového rozhraní. Volající musí po volání Networking_GetInterfacesCount přidělit paměť pro pole, aby načetl počet rozhraní na zařízení.

  • networkInterfacesArrayCount Počet prvků, které outNetworkInterfacesArray může obsahovat. Pole by mělo mít jeden prvek pro každé síťové rozhraní v zařízení.

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EFAULT: outNetworkInterfacesArray Parametr je NULL.

  • ERANGE: networkInterfacesArrayCount parmaeter je 0.

  • EAGAIN: Síťový zásobník ještě není připravený.

Je také možné zadat všechny ostatní errno chyby. Tyto chyby nejsou deterministické a stejné chování nemusí být zachováno prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí počet síťových rozhraní přidaných do outNetworkInterfaces pole. V opačném případě je hodnota -1 pro selhání nastavená errno na chybovou hodnotu.

Koncepty a ukázky