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
會設為錯誤值。