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 ,设置为错误值。

概念和示例