Networking_GetInterfaces-Funktion

Header: #include <applibs/networking.h>

Ruft die Liste der Netzwerkschnittstellen in einem Azure Sphere-Gerät ab. Wenn outNetworkInterfaces zu klein ist, um alle Netzwerkschnittstellen im System aufzunehmen, füllt diese Funktion das Array aus und gibt die Anzahl der Arrayelemente zurück. Die Anzahl der Schnittstellen im System ändert sich innerhalb eines Startzyklus nicht.

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

Parameter

• outNetworkInterfacesArray Ein Zeiger auf ein Array von Networking_NetworkInterface Strukturen, die mit Netzwerkschnittstelleneigenschaften gefüllt werden sollen. Der Aufrufer muss nach dem Aufruf von Networking_GetInterfacesCount Arbeitsspeicher für das Array zuweisen, um die Anzahl der Schnittstellen auf dem Gerät abzurufen.

• networkInterfacesArrayCount Die Anzahl der Elemente outNetworkInterfacesArray , die enthalten sein können. Das Array sollte über ein Element für jede Netzwerkschnittstelle auf dem Gerät verfügen.

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

• EFAULT: Der outNetworkInterfacesArray Parameter ist NULL.

• ERANGE: Der networkInterfacesArrayCount Parmaeter ist 0.

• EAGAIN: Der Netzwerkstapel ist noch nicht bereit.

Auch andere errno Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und dasselbe Verhalten wird möglicherweise nicht durch Systemupdates beibehalten.

Rückgabewert

Gibt die Anzahl der Netzwerkschnittstellen zurück, die dem outNetworkInterfaces Array hinzugefügt wurden. Andernfalls -1 für Fehler, in diesem Fall errno wird auf den Fehlerwert festgelegt.

Konzepte und Beispiele

• Beispiel: Private Netzwerkdienste