Compartir vía


Función WifiConfig_SetClientCertStoreIdentifier

Encabezado: #include <applibs/wificonfig.h>

Establece el identificador del certificado almacenado para usarlo como certificado de cliente para una red Wi-Fi. La configuración entrará en vigor inmediatamente, pero se perderá al reiniciar, a menos que la aplicación llame a WifiConfig_PersistConfig después de que se devuelva esta función.

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

Parámetros

  • networkId El id. de la red que se va a configurar. WifiConfig_AddNetwork devuelve el id. de red.

  • certStoreIdentifier Un puntero al nombre del certificado. El nombre debe ser una cadena única de uno a CERTSTORE_MAX_IDENTIFIER_LENGTH bytes de largo, excluyendo el carácter terminador NULL.

Errores

Devuelve -1 si se produce 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.