WifiConfig_SetRootCACertStoreIdentifier işlevi

  • Makale

Üst bilgi: #include <applibs/wificonfig.h>

Depolanan sertifikanın tanımlayıcısını bir ağ için kök sertifika yetkilisi olarak kullanacak şekilde ayarlar. Tanımlayıcı ayarlanmamışsa, cihaz bağlandığı sunucunun kimliğini doğrulamaz. Ayar hemen geçerli olur, ancak bu işlevden sonra WifiConfig_PersistConfig işlevi çağrılmadığı sürece yeniden başlatmada kaybolur.

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

Parametre

  • networkId Sertifika deposu tanımlayıcısının ayarlanacağı ağın kimliği. WifiConfig_AddNetwork ağ kimliğini döndürür.

  • certStoreIdentifier Sertifikanın adını içeren sabit null ile sonlandırılan karakter dizesinin işaretçisi. Ad, bir karakterden karaktere CERTSTORE_MAX_IDENTIFIER_LENGTH kadar benzersiz bir dize olmalıdır. Ayrıntılar için bkz. CertStore_InstallRootCACertificate işlevi .

Hata

Hatayla karşılaşılırsa ve hata değerine ayarlanırsa errno -1 döndürür.

  • EACCES: Uygulama bildirimi EnterpriseWifiConfig özelliğini içermez.

  • EFAULT: certStoreIdentifier parametresi NULL'dir.

  • ERANGE: parametresinin uzunluğu değerinden certStoreIdentifierCERTSTORE_MAX_IDENTIFIER_LENGTHbüyüktür.

  • EAGAIN: Wi-Fi cihazı hazır değil.

  • ENETDOWN: Wi-Fi ağ arabirimi kullanılamıyor.

  • EINVAL: networkId parametre geçersiz.

  • ENODEV: networkId parametresi depolanan ağların kimlikleriyle eşleşmiyor.

Diğer errno hatalar da belirtilebilir; bu tür hatalar belirleyici değildir ve sistem güncelleştirmeleri aracılığıyla aynı davranışın korunacağının garantisi yoktur.

Dönüş değeri

Başarı için 0 veya hata için -1 döndürür; bu durumda errno hata değerine ayarlanır.

Uygulama bildirimi gereksinimleri

Uygulama bildirimi EnterpriseWifiConfig özelliğini içermelidir.