共用方式為


Networking_GetInterfaces函數

頁首: #include < applibs/networking。h>

取得 Azure 球體裝置中的網路介面清單。 如果 outNetworkInterfaces 太小而無法保存系統中的所有網路介面,此函數會填滿陣列並傳回陣列元素的數目。 系統中的介面數量不會在開機週期內變更。

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

參數

  • outNetworkInterfacesArray 指標指向 Networking_NetworkInterface 指示陣列以填滿網路介面屬性。 呼叫Networking_GetInterfacesCount之後,來電者必須為數組配置記憶體 ,以擷 取裝置上的介面數目。

  • networkInterfacesArrayCount 可以保留的元素 outNetworkInterfacesArray 數目。 陣列應該會有裝置上每個網路介面的一個元素。

錯誤

如果發生錯誤並設定為 errno 錯誤值,則傳回 -1。

  • EFAULT:參數 outNetworkInterfacesArray 為 Null。

  • ERANGE: networkInterfacesArrayCount parmaeter 為 0。

  • EAGAIN:網路堆疊尚未準備就緒。

您也可以指定任何其他 errno 錯誤;這類錯誤不是不確定的,同樣的行為可能無法透過系統更新來保留。

傳回值

傳回新增至陣列的 outNetworkInterfaces 網路介面數目。 否則 -1 則為失敗,在這種情況下 errno 會設為錯誤值。

概念和範例