Dela via


funktionen WifiConfig_SetRootCACertStoreIdentifier

Sidhuvud: #include <applibs/wificonfig.h>

Anger identifieraren för det lagrade certifikatet som ska användas som rotcertifikatutfärdare för ett nätverk. Om identifieraren inte har angetts autentiserar enheten inte servern som den ansluter till. Inställningen börjar gälla omedelbart men kommer att gå förlorad vid en omstart om inte funktionen WifiConfig_PersistConfig anropas efter den här funktionen.

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

Parametrar

  • networkId ID för nätverket som certifikatarkivets ID ska anges för. WifiConfig_AddNetwork returnerar nätverks-ID: et.

  • certStoreIdentifier En pekare till en konstant null-avsluten teckensträng som innehåller namnet på certifikatet. Namnet måste vara en unik sträng från ett till CERTSTORE_MAX_IDENTIFIER_LENGTH tecken. Mer information finns i funktionen CertStore_InstallRootCACertificate .

Fel

Returnerar -1 om ett fel uppstår och anger errno felvärdet.

  • EACCES: Programmanifestet innehåller inte EnterpriseWifiConfig-funktionen.

  • EFAULT: parametern certStoreIdentifier är NULL.

  • ERANGE: parameterns certStoreIdentifier längd är större än CERTSTORE_MAX_IDENTIFIER_LENGTH.

  • EAGAIN: Wi-Fi-enheten är inte klar.

  • ENETDOWN: det Wi-Fi nätverksgränssnittet är inte tillgängligt.

  • EINVAL: parametern networkId är ogiltig.

  • ENODEV: parametern networkId matchar inte något av ID:na för de lagrade nätverken.

errno Andra kan också anges, sådana fel är inte deterministiska och det finns ingen garanti för att samma beteende behålls via systemuppdateringar.

Returvärde

Returnerar 0 för lyckat resultat, eller -1 för fel, i vilket fall errno är inställt på felvärdet.

Krav för programmanifest

Programmanifestet måste innehålla EnterpriseWifiConfig-funktionen.