Compartir a través de

función WifiConfig_SetRootCACertStoreIdentifier

  • Artículo

Encabezado: #include <applibs/wificonfig.h>

Establece el identificador del certificado almacenado para usarlo como entidad emisora de certificados raíz para una red. Si el identificador no está establecido, el dispositivo no autenticará el servidor al que se conecta. La configuración entrará en vigor inmediatamente, pero se perderá al reiniciar, a menos que se llame a la función WifiConfig_PersistConfig después de esta función.

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

Parámetros

  • networkId El identificador de la red para el que establecer el identificador del almacén de certificados. WifiConfig_AddNetwork devuelve el id. de red.

  • certStoreIdentifier Puntero a cadena de caracteres terminada en null constante que contiene el nombre del certificado. El nombre debe ser una cadena única de uno a CERTSTORE_MAX_IDENTIFIER_LENGTH caracteres de longitud. Vea CertStore_InstallRootCACertificate función para obtener más información.

Errores

Devuelve -1 si se encuentra un error y se establece errno en el valor de error.

  • EACCES: el manifiesto de la aplicación no incluye la funcionalidad EnterpriseWifiConfig.

  • EFAULT: el certStoreIdentifier parámetro es NULL.

  • ERANGE: la longitud del certStoreIdentifier parámetro es mayor que CERTSTORE_MAX_IDENTIFIER_LENGTH.

  • EAGAIN: el dispositivo Wi-Fi no está listo.

  • ENETDOWN: la interfaz de red Wi-Fi no está disponible.

  • EINVAL: el networkId parámetro no es válido.

  • ENODEV: el networkId parámetro no coincide con ninguno de los identificadores de las redes almacenadas.

También se puede especificar cualquier otro errno error; estos errores no son deterministas y no hay ninguna garantía de que el mismo comportamiento se conservará a través de las actualizaciones del sistema.

Valor devuelto

Devuelve 0 para éxito o -1 para error, en cuyo caso errno se establece en el valor de error.

Requisitos del manifiesto de la aplicación

El manifiesto de la aplicación debe incluir la funcionalidad EnterpriseWifiConfig.