Condividi tramite

WifiConfig_SetRootCACertStoreIdentifier

  • Articolo

Intestazione: #include <applibs/wificonfig.h>

Imposta l'identificatore del certificato archiviato da usare come autorità di certificazione radice per una rete. Se l'identificatore non è impostato, il dispositivo non autentica il server a cui si connette. L'impostazione è effettiva immediatamente, ma verrà persa durante un riavvio, a meno che la funzione WifiConfig_PersistConfig non venga chiamata dopo questa funzione.

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

Parametri

  • networkId ID della rete per cui impostare l'identificatore dell'archivio certificati. WifiConfig_AddNetwork restituisce l'ID di rete.

  • certStoreIdentifier Puntatore a una stringa di caratteri costante terminata da null che contiene il nome del certificato. Il nome deve essere una stringa univoca da uno a CERTSTORE_MAX_IDENTIFIER_LENGTH caratteri di lunghezza. Per informazioni dettagliate, vedere CertStore_InstallRootCACertificate funzione .

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.