Share via


WifiConfig_SetClientCertStoreIdentifier İşlevi

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

Bir Wi-Fi ağı için istemci sertifikası olarak kullanılacak depolanmış sertifikanın tanımlayıcısını ayarlar. Ayar hemen geçerli olur, ancak uygulama bu işlev döndürdüğünde WifiConfig_PersistConfig çağırmadığı sürece yeniden başlatmada kaybolur.

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

Parametre

  • networkId Yapılandırılan ağın kimliği. WifiConfig_AddNetwork ağ kimliğini döndürür.

  • certStoreIdentifier Sertifikanın adına işaret eden bir işaretçi. Ad, NULL sonlandırıcı karakteri hariç olmak üzere bir ile CERTSTORE_MAX_IDENTIFIER_LENGTH bayt uzunluğunda benzersiz bir dize olmalıdır.

Hata

Hata oluşursa -1 döndürür ve hata değerine ayarlar errno .

  • 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.