Udostępnij za pośrednictwem

funkcja WifiConfig_SetRootCACertStoreIdentifier

  • Artykuł

Nagłówek: #include <applibs/wificonfig.h>

Ustawia identyfikator przechowywanego certyfikatu, który ma być używany jako główny urząd certyfikacji dla sieci. Jeśli identyfikator nie jest ustawiony, urządzenie nie uwierzytelni serwera, z którym nawiązuje połączenie. Ustawienie jest skuteczne natychmiast, ale zostanie utracone po ponownym uruchomieniu, chyba że funkcja WifiConfig_PersistConfig zostanie wywołana po tej funkcji.

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

Parametry

  • networkId Identyfikator sieci, dla której ma zostać ustawiony identyfikator magazynu certyfikatów. WifiConfig_AddNetwork zwraca identyfikator sieci.

  • certStoreIdentifier Wskaźnik do ciągu znaków stałej zakończonej wartością null zawierającego nazwę certyfikatu. Nazwa musi być unikatowym ciągiem o długości od jednego do CERTSTORE_MAX_IDENTIFIER_LENGTH znaków. Aby uzyskać szczegółowe informacje , zobacz CertStore_InstallRootCACertificate funkcji .

Błędy

Zwraca wartość -1 w przypadku napotkania błędu i ustawia errno wartość błędu.

  • EACCES: manifest aplikacji nie zawiera funkcji EnterpriseWifiConfig.

  • EFAULT: certStoreIdentifier parametr ma wartość NULL.

  • ERANGE: długość parametru certStoreIdentifier jest większa niż CERTSTORE_MAX_IDENTIFIER_LENGTH.

  • EAGAIN: urządzenie Wi-Fi nie jest gotowe.

  • ENETDOWN: Wi-Fi interfejs sieciowy jest niedostępny.

  • EINVAL: parametr jest nieprawidłowy networkId .

  • ENODEV: networkId parametr nie odpowiada żadnym identyfikatorom przechowywanych sieci.

Mogą być również określone inne errno błędy; takie błędy nie są deterministyczne i nie ma gwarancji, że to samo zachowanie zostanie zachowane za pośrednictwem aktualizacji systemu.

Zwracana wartość

Zwraca wartość 0 dla powodzenia lub -1 dla niepowodzenia, w którym to przypadku errno jest ustawiona wartość błędu.

Wymagania dotyczące manifestu aplikacji

Manifest aplikacji musi zawierać funkcję EnterpriseWifiConfig.