WifiConfig_SetRootCACertStoreIdentifier functie

Header: #include <applibs/wificonfig.h>

Hiermee stelt u de id van het opgeslagen certificaat in dat moet worden gebruikt als de basiscertificeringsinstantie voor een netwerk. Als de id niet is ingesteld, verifieert het apparaat niet de server waarmee het verbinding maakt. De instelling is onmiddellijk van kracht, maar gaat verloren bij het opnieuw opstarten, tenzij de functie WifiConfig_PersistConfig wordt aangeroepen na deze functie.

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

Parameters

• networkId De id van het netwerk waarvoor de id van het certificaatarchief moet worden ingesteld. WifiConfig_AddNetwork retourneert de netwerk-id.

• certStoreIdentifier Een aanwijzer naar een tekenreeks met een constante null-beëindigde tekenreeks die de naam van het certificaat bevat. De naam moet een unieke tekenreeks van één tot CERTSTORE_MAX_IDENTIFIER_LENGTH tekens lang zijn. Zie CertStore_InstallRootCACertificate functie voor meer informatie.

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

• EACCES: het toepassingsmanifest bevat niet de mogelijkheid EnterpriseWifiConfig.

• EFAULT: de certStoreIdentifier parameter is NULL.

• ERANGE: de lengte van de certStoreIdentifier parameter is groter dan CERTSTORE_MAX_IDENTIFIER_LENGTH.

• EAGAIN: het Wi-Fi apparaat is niet gereed.

• ENETDOWN: de Wi-Fi netwerkinterface is niet beschikbaar.

• EINVAL: de networkId parameter is ongeldig.

• ENODEV: de networkId parameter komt niet overeen met een van de id's van de opgeslagen netwerken.

errno Andere fouten kunnen ook worden opgegeven; dergelijke fouten zijn niet deterministisch en er is geen garantie dat hetzelfde gedrag wordt behouden via systeemupdates.

Retourwaarde

Retourneert 0 voor geslaagd, of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid EnterpriseWifiConfig bevatten.