通过

WifiConfig_AddDuplicateNetwork 函数

  • 项目

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

添加一个新网络，该网络是具有指定 ID 的指定网络的副本。 为新网络分配指定名称，默认情况下会禁用。

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

参数

  • networkId 要复制的网络的 ID。 WifiConfig_AddNetwork 返回网络 ID。

  • configName 指向包含配置名称的字节数组的指针。 数组必须以 NULL 结尾，且最多WIFICONFIG_CONFIG_NAME_MAX_LENGTH字节，不包括终止字符。

错误

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

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

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

  • EEXIST： configName 不是唯一的。

  • EFAULT：为 configName NULL。

  • EINVAL： networkId 无效。

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

  • ENODEV： networkId 与任何存储的网络都不匹配。

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

  • ERANGE： configName 少于一个字符或多于WIFICONFIG_CONFIG_NAME_MAX_LENGTH个字符。

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

返回值

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

言论

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

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

应用程序清单要求

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