WifiConfig_ForgetNetwork関数

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

大事な

この関数は廃止されました。 代わりに WifiConfig_ForgetNetworkById を使用します。

デバイスから Wi-Fi ネットワークを削除します。 現在接続されている場合は、デバイスをネットワークから切断します。 この関数はスレッド セーフではありません。

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

パラメーター

• storedNetwork 削除する格納されている Wi-Fi ネットワークを記述するWifiConfig_StoredNetwork構造体へのポインター。

エラー

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

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

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

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

• EINVAL: パラメーターまたはその構造体の storedNetwork バージョンが無効です。

• EAGAIN: Wi-Fi デバイスの準備がまだ整っていません。

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

• ENOSPC: 構成を保持するには、Wi-Fi ネットワークが多すぎます。1 つを削除し、もう一度やり直してください。

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

戻り値

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

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

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