WifiConfig_SetPSK函数

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

为 Wi-Fi 网络设置预共享密钥 (PSK) 。 PSK 用于配置了 WifiConfig_Security_Wpa2_Psk 安全类型的网络。

此设置立即生效，但在设备重新启动后不会保留，除非在此函数之后调用 WifiConfig_PersistConfig 函数。

static int WifiConfig_SetPSK(int networkId, const char *psk, size_t pskLength);

参数

• networkId 要配置的网络的 ID。 WifiConfig_AddNetwork 返回网络 ID。

• psk 指向包含网络的 PSK 的缓冲区的指针。

• pskLength 网络的 PSK 长度。 此参数必须小于或等于 WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE。

错误

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

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

• EFAULT： psk 参数为 NULL。

• ERANGE： pskLength 参数大于 WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE。

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

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

• EINVAL： networkId 参数无效。

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

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

返回值

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

应用程序清单要求

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