Поделиться через

функция WifiConfig_SetRootCACertStoreIdentifier

  • Статья

Заголовок: #include <applibs/wificonfig.h>

Задает идентификатор хранимого сертификата, который будет использоваться в качестве корневого центра сертификации для сети. Если идентификатор не задан, устройство не будет проверять подлинность сервера, к которому оно подключается. Параметр вступает в силу немедленно, но будет потерян при перезагрузке, если после этой функции не будет вызвана функция WifiConfig_PersistConfig .

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

Параметры

  • networkId Идентификатор сети, для которой необходимо задать идентификатор хранилища сертификатов. WifiConfig_AddNetwork возвращает идентификатор сети.

  • certStoreIdentifier Указатель на константную символьную строку, завершающуюся null, которая содержит имя сертификата. Имя должно быть уникальной строкой от одного до CERTSTORE_MAX_IDENTIFIER_LENGTH символов в длину. Дополнительные сведения см . в разделе функция CertStore_InstallRootCACertificate .

Ошибки

Возвращает значение -1 при обнаружении ошибки и задает errno значение ошибки.

  • EACCES: манифест приложения не включает возможность EnterpriseWifiConfig.

  • EFAULT: certStoreIdentifier параметр имеет значение NULL.

  • ERANGE: длина certStoreIdentifier параметра больше CERTSTORE_MAX_IDENTIFIER_LENGTH.

  • EAGAIN: Wi-Fi устройство не готово.

  • ENETDOWN: сетевой интерфейс Wi-Fi недоступен.

  • EINVAL: networkId параметр недопустим.

  • ENODEV: networkId параметр не соответствует ни одному из идентификаторов хранимых сетей.

Можно также указать любой другой errno вариант. Такие ошибки не являются детерминированными, и нет никакой гарантии, что такое же поведение будет сохранено при обновлении системы.

Возвращаемое значение

Возвращает значение 0 для успешного выполнения или -1 для сбоя. В этом случае errno задается значение ошибки.

Требования к манифесту приложения

Манифест приложения должен включать возможность EnterpriseWifiConfig.