Share via

Networking_GetInterfaces İşlevi

  • Makale

Üst bilgi: applibs/networking.h #include <>

Azure Sphere cihazındaki ağ arabirimlerinin listesini alır. Sistemdeki tüm ağ arabirimlerini barındıramayacak kadar küçükse outNetworkInterfaces , bu işlev diziyi doldurur ve dizi öğelerinin sayısını döndürür. Sistemdeki arabirimlerin sayısı önyükleme döngüsü içinde değişmez.

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

Parametre

  • outNetworkInterfacesArray Ağ arabirimi özellikleriyle doldurulacak bir dizi Networking_NetworkInterface yapısına yönelik bir işaretçi. Çağıranın, cihazdaki arabirim sayısını almak için Networking_GetInterfacesCount çağırdıktan sonra dizi için bellek ayırması gerekir.

  • networkInterfacesArrayCount Tutulabilecek öğe outNetworkInterfacesArray sayısı. Dizi, cihazdaki her ağ arabirimi için bir öğeye sahip olmalıdır.

Hata

Hatayla karşılaşılırsa ve hata değerine ayarlanırsa errno -1 döndürür.

  • EFAULT: outNetworkInterfacesArray parametresi NULL'dir.

  • ERANGE: networkInterfacesArrayCount parmaeter 0'dır.

  • EAGAIN: Ağ yığını henüz hazır değil.

Diğer errno hatalar da belirtilebilir; bu tür hatalar belirlenimci değildir ve sistem güncelleştirmeleri aracılığıyla aynı davranış korunmayabilir.

Dönüş değeri

Diziye outNetworkInterfaces eklenen ağ arabirimlerinin sayısını döndürür. Aksi takdirde hata için -1, bu durumda errno hata değerine ayarlanır.

Kavramlar ve örnekler