Sdílet prostřednictvím

WifiConfig_SetRootCACertStoreIdentifier funkce

  • Článek

Hlavička: #include <applibs/wificonfig.h>

Nastaví identifikátor uloženého certifikátu, který se použije jako kořenová certifikační autorita pro síť. Pokud identifikátor není nastavený, zařízení neověří server, ke kterému se připojuje. Nastavení je účinné okamžitě, ale během restartování se ztratí, pokud se po této funkci nezavolá funkce WifiConfig_PersistConfig .

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

Parametry

  • networkId ID sítě, pro kterou se má nastavit identifikátor úložiště certifikátů. WifiConfig_AddNetwork vrátí ID sítě.

  • certStoreIdentifier Ukazatel na řetězec konstantního znaku s ukončenou hodnotou null, který obsahuje název certifikátu. Název musí být jedinečný řetězec o délce od jednoho po CERTSTORE_MAX_IDENTIFIER_LENGTH znaky. Podrobnosti najdete v tématu CertStore_InstallRootCACertificate funkce .

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EACCES: Manifest aplikace neobsahuje funkci EnterpriseWifiConfig.

  • EFAULT: certStoreIdentifier Parametr je NULL.

  • ERANGE: Délka parametru certStoreIdentifier je větší než CERTSTORE_MAX_IDENTIFIER_LENGTH.

  • EAGAIN: zařízení Wi-Fi není připravené.

  • ENETDOWN: Wi-Fi síťové rozhraní není k dispozici.

  • EINVAL: networkId Parametr je neplatný.

  • ENODEV: networkId Parametr neodpovídá žádnému z ID uložených sítí.

Je také možné zadat jakékoli jiné errno chyby. Tyto chyby nejsou deterministické a neexistuje žádná záruka, že se stejné chování zachová prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí hodnotu 0 pro úspěch nebo -1 pro selhání. V tomto případě errno je nastavená na chybovou hodnotu.

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci EnterpriseWifiConfig.