Funzione WifiConfig_SetClientCertStoreIdentifier

  • Articolo

Intestazione: #include <applibs/wificonfig.h>

Imposta l'identificatore del certificato archiviato da usare come certificato client per una rete Wi-Fi. L'impostazione ha effetto immediato, ma verrà persa durante un riavvio, a meno che l'app non chiami WifiConfig_PersistConfig dopo il ritorno della funzione.

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

Parametri

  • networkId ID della rete da configurare. WifiConfig_AddNetwork restituisce l'ID di rete.

  • certStoreIdentifier Puntatore al nome del certificato. Il nome deve essere una stringa univoca lunga da uno a CERTSTORE_MAX_IDENTIFIER_LENGTH byte, escluso il carattere di terminazione NULL.

Errori

Restituisce -1 se si verifica un errore e imposta errno il valore di errore.

  • EACCES: il manifesto dell'applicazione non include la funzionalità EnterpriseWifiConfig .

  • EFAULT: il certStoreIdentifier parametro è NULL.

  • ERANGE: la lunghezza del certStoreIdentifier parametro è maggiore di CERTSTORE_MAX_IDENTIFIER_LENGTH.

  • EAGAIN: il dispositivo Wi-Fi non è pronto.

  • ENETDOWN: l'interfaccia di rete Wi-Fi non è disponibile.

  • EINVAL: il networkId parametro non è valido.

  • ENODEV: il networkId parametro non corrisponde a nessuno degli ID delle reti archiviate.

Potrebbero anche essere specificati altri errno errori. Tali errori non sono deterministici e non vi è alcuna garanzia che lo stesso comportamento verrà mantenuto tramite gli aggiornamenti di sistema.

Valore restituito

Restituisce 0 per operazione riuscita o -1 per errore, nel qual caso errno è impostato sul valore di errore.

Requisiti del manifesto dell'applicazione

Il manifesto dell'applicazione deve includere la funzionalità EnterpriseWifiConfig.