WifiConfig_AddNetwork関数

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

Wi-Fi ネットワークをデバイスに追加し、ネットワークの ID を返します。

int WifiConfig_AddNetwork(void);

エラー

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

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

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

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

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

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

戻り値

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

発言

ネットワーク ID は、WifiConfig_SetSSID などのWifiConfig_Set* 関数に渡されます。

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

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

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

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