次の方法で共有


WifiConfig_SetRootCACertStoreIdentifier関数

ヘッダー: applibs </wificonfig.h #include>

ネットワークのルート証明機関として使用する格納されている証明書の識別子を設定します。 識別子が設定されていない場合、デバイスは接続先のサーバーを認証しません。 設定はすぐに有効ですが、この関数の後に WifiConfig_PersistConfig 関数が呼び出されない限り、再起動後に失われます。

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

パラメーター

  • networkId 証明書ストア識別子を設定するネットワークの ID。 WifiConfig_AddNetwork は、ネットワーク ID を返します。

  • certStoreIdentifier 証明書の名前を含む定数 null で終わる文字列へのポインター。 名前は、長さが 1 文字から 1 文字までの CERTSTORE_MAX_IDENTIFIER_LENGTH 一意の文字列である必要があります。 詳細については 、「CertStore_InstallRootCACertificate関数 」を参照してください。

エラー

エラーが発生した場合は -1 を返し、エラー値に設定します errno

  • EACCES: アプリケーション マニフェストに EnterpriseWifiConfig 機能が含まれていません。

  • EFAULT: パラメーターは certStoreIdentifier NULL です。

  • ERANGE: パラメーターの certStoreIdentifier 長さが より CERTSTORE_MAX_IDENTIFIER_LENGTH大きい。

  • EAGAIN: Wi-Fi デバイスの準備ができていない。

  • ENETDOWN: Wi-Fi ネットワーク インターフェイスは使用できません。

  • EINVAL: networkId パラメーターが無効です。

  • ENODEV: パラメーターはnetworkId、格納されているネットワークの ID のいずれにも一致しません。

その他 errno のエラーも指定できます。このようなエラーは決定的ではなく、システムの更新によって同じ動作が保持される保証はありません。

戻り値

成功の場合は 0、失敗の場合は -1 を返します。この場合 errno はエラー値に設定されます。

アプリケーション マニフェストの要件

アプリケーション マニフェストには、EnterpriseWifiConfig 機能が含まれている必要があります。