WifiConfig_SetRootCACertStoreIdentifier 函数

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

设置要用作网络的根证书颁发机构的存储证书的标识符。 如果未设置标识符，设备将不会对连接到的服务器进行身份验证。 设置立即生效，但在重新启动时会丢失，除非在此函数之后调用 WifiConfig_PersistConfig 函数。

static int WifiConfig_SetRootCACertStoreIdentifier(int networkId, const char *certStoreIdentifier);

参数

• networkId 要为其设置证书存储标识符的网络的 ID。 WifiConfig_AddNetwork 返回网络 ID。

• certStoreIdentifier 指向包含证书名称的以 null 结尾的常量字符串的指针。 名称必须是长度为 1 到 CERTSTORE_MAX_IDENTIFIER_LENGTH 字符的唯一字符串。 有关详细信息 ，请参阅 CertStore_InstallRootCACertificate 函数 。

错误

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

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

• EFAULT： certStoreIdentifier 参数为 NULL。

• ERANGE：参数的 certStoreIdentifier 长度大于 CERTSTORE_MAX_IDENTIFIER_LENGTH。

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

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

• EINVAL： networkId 参数无效。

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

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

返回值

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

应用程序清单要求

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