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 機能が含まれている必要があります。