次の方法で共有

WifiConfig_AddDuplicateNetwork関数

  • [アーティクル]

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

指定した ID を持つ指定したネットワークの複製である新しいネットワークを追加します。 新しいネットワークには指定した名前が割り当てられ、既定では無効になっています。

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

パラメーター

  • networkId 複製するネットワークの ID。 WifiConfig_AddNetwork は、ネットワーク ID を返します。

  • configName 構成名を含むバイト配列へのポインター。 配列は NULL で終端され、終了文字を除く最大WIFICONFIG_CONFIG_NAME_MAX_LENGTHバイトである必要があります。

エラー

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

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

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

  • EEXIST: は configName 一意ではありません。

  • EFAULT: は configName NULL です。

  • EINVAL: が networkId 無効です。

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

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

  • ENOMEM: 新しいネットワークを追加するのに十分なメモリがありません。

  • ERANGE: が configName 1 文字未満であるか、WIFICONFIG_CONFIG_NAME_MAX_LENGTH文字を超えています。

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

戻り値

新しいネットワークの ID を返します。エラーの場合は -1 を返します。この場合 errno はエラー値に設定されます。 ネットワーク ID は 0 または正の値です。

発言

新しいネットワークは構成されておらず、 WifiConfig_Set* 関数を使用して構成できます。 ネットワーク構成の変更はすぐに有効ですが、 WifiConfig_PersistConfig 関数が呼び出されて構成が不揮発性ストレージに保存されない限り、デバイスの再起動時に失われます。

デバイスに格納できるネットワークの数は固定されませんが、使用可能なリソースと各ネットワーク構成に必要なストレージの量によって異なります。

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

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