共用方式為


WifiConfig_SetRootCACertStoreIdentifier函數

頁首: #include < applibs/wificonfig.h>

設定儲存之憑證的識別碼,以做為網路的跟憑證授權單位單位。 如果未設定識別碼,裝置將不會驗證其連線的伺服器。 此設定會立即生效,但會在重新開機時遺失,除非在此函數之後撥打 WifiConfig_PersistConfig 函數。

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

參數

  • networkId 用來設定憑證存放區識別碼的網路識別碼。 WifiConfig_AddNetwork 傳回網路識別碼。

  • certStoreIdentifier 指向包含憑證名稱之常數 Null 終止字串的指標。 名稱必須是長度從一個字元到 CERTSTORE_MAX_IDENTIFIER_LENGTH 一個字元的唯一字串。 如 需詳細資訊, 請參閱CertStore_InstallRootCACertificate函數。

錯誤

如果發生錯誤並設定為 errno 錯誤值,則傳回 -1。

  • EACCES:應用程式資訊清單不包含 EnterpriseWifiConfig 功能。

  • EFAULT:參數 certStoreIdentifier 為 Null。

  • ERANGE:參數的 certStoreIdentifier 長度大於 CERTSTORE_MAX_IDENTIFIER_LENGTH

  • EAGAIN:Wi-Fi 裝置尚未準備就緒。

  • ENETDOWN:無法使用 Wi-Fi 網路介面。

  • EINVAL:參數 networkId 無效。

  • ENODEV:參數 networkId儲存網路的任何識別碼不相符。

您也可以指定任何其他 errno 錯誤;這類錯誤並非確定性錯誤,而且不保證會透過系統更新保留相同的行為。

傳回值

會傳回 0 表示成功,而失敗則傳回 -1,在這種情況下 errno 會設定為錯誤值。

應用程式資訊清單需求

應用程式 資訊清單 必須包含 EnterpriseWifiConfig 功能。