Networking_GetInterfaces 函数
标头: #include <applibs/networking.h>
获取 Azure Sphere 设备中的网络接口列表。 如果 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
分析者为 0。EAGAIN:网络堆栈尚未准备就绪。
还可以指定任何其他 errno
错误;此类错误不是确定性的,并且可能不会通过系统更新保留相同的行为。
返回值
返回添加到数组的 outNetworkInterfaces
网络接口数。 否则为 -1 表示失败,在这种情况下 errno
,设置为错误值。