Funzione Networking_GetInterfaces

  • Articolo

Intestazione: #include <applicazioni/networking.h>

Ottiene l'elenco delle interfacce di rete in un dispositivo Azure Sphere. Se outNetworkInterfaces è troppo piccola per contenere tutte le interfacce di rete nel sistema, questa funzione riempie la matrice e restituisce il numero di elementi della matrice. Il numero di interfacce nel sistema non cambia all'interno di un ciclo di avvio.

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

Parametri

  • outNetworkInterfacesArray Puntatore a una matrice di Networking_NetworkInterface structs da riempire con le proprietà dell'interfaccia di rete. Il chiamante deve allocare memoria per la matrice dopo aver chiamato Networking_GetInterfacesCount per recuperare il numero di interfacce nel dispositivo.

  • networkInterfacesArrayCount Il numero di elementi outNetworkInterfacesArray che possono contenere. La matrice deve avere un elemento per ogni interfaccia di rete del dispositivo.

Errori

Restituisce -1 se si verifica un errore e imposta errno il valore di errore.

  • EFAULT: il outNetworkInterfacesArray parametro è NULL.

  • ERANGE: il networkInterfacesArrayCount livello è 0.

  • EAGAIN: lo stack di rete non è ancora pronto.

Potrebbero anche essere specificati altri errno errori. Tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti di sistema.

Valore restituito

Restituisce il numero di interfacce di rete aggiunte alla outNetworkInterfaces matrice. In caso contrario -1 per errore, nel qual caso errno è impostato sul valore di errore.

Concetti ed esempi