通过

WifiConfig_AddNetwork 函数

  • 项目

标头： #include <applibs/wificonfig.h>

将 Wi-Fi 网络添加到设备，并返回网络的 ID。

int WifiConfig_AddNetwork(void);

错误

如果遇到错误并设置为 errno 错误值，则返回 -1。

  • EACCES：应用程序清单不包括 WifiConfig 功能。

  • EAGAIN：Wi-Fi 设备未准备就绪。

  • ENETDOWN：Wi-Fi 网络接口不可用。

  • ENOMEM：内存不足，无法添加新网络。

还可以指定任何其他 errno 错误;此类错误不是确定性的，并且可能不会通过系统更新保留相同的行为。

返回值

返回新网络的 ID，如果失败，则返回 -1，在这种情况下 errno ，将 设置为错误值。 网络 ID 为零或正值。

言论

网络 ID 传递给 WifiConfig_Set* 函数，例如 WifiConfig_SetSSID。

新网络未配置，可以使用 WifiConfig_Set* 函数进行配置。 对网络配置的更改会立即生效，但在设备重新启动时会丢失，除非调用 WifiConfig_PersistConfig 函数将配置保存到非易失性存储。

可以在设备上存储的网络数不是固定的，但取决于可用资源和每个网络配置所需的存储量。

应用程序清单要求

应用程序清单必须包含 WifiConfig 功能。