WifiConfig_SetClientCertStoreIdentifier 函数

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

设置要用作 Wi-Fi 网络的客户端证书的存储证书的标识符。 设置立即生效,但在重新启动时会丢失,除非应用在此函数返回后调用 WifiConfig_PersistConfig

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

参数

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

  • certStoreIdentifier 指向证书名称的指针。 名称必须是长度为 1 到 CERTSTORE_MAX_IDENTIFIER_LENGTH 字节的唯一字符串,不包括 NULL 终止符字符。

错误

如果发生错误并设置为 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 功能。