通过

WifiConfig_StoreWpa2Network 函数

  • 项目

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

重要

此函数已过时。 请改用 WifiConfig_AddNetwork 。

存储使用预共享密钥的 WPA2 Wi-Fi 网络。 此函数不是线程安全的。

注意

如果已存储具有相同 SSID 和预共享密钥的网络，则此函数将失败。 请参阅 EEXIST) (错误部分。

int WifiConfig_StoreWpa2Network(const uint8_t * ssid, size_t ssidLength, const char * psk, size_t pskLength);

参数

  • ssid 指向 SSID 字节数组的指针，该数组具有标识 Wi-Fi 网络的未指定字符编码。

  • ssidLength Wi-Fi 网络的 SSID 中的字节数。

  • psk 指向缓冲区的指针，该缓冲区包含 Wi-Fi 网络的预共享密钥。

  • pskLength Wi-Fi 网络的预共享密钥的长度。

错误

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

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

  • EEXIST：已存在具有相同 SSID 且使用 WPA2 的存储 Wi-Fi 网络。

  • EFAULT： ssid 或 psk 为 NULL。

  • ERANGE： ssidLength 或 pskLength 参数为 0 或大于 WIFICONFIG_SSID_MAX_LENGTH 和 WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE。

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

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

  • ENOSPC：Wi-Fi 网络太多，无法保留配置;删除一个，然后重试。

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

返回值

如果成功，则返回 0，如果失败，则返回 -1，在这种情况下 errno ，将 设置为错误值。

应用程序清单要求

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