WifiConfig_StoreOpenNetwork関数

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

大事な

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

キーなしで開いている Wi-Fi ネットワークを格納します。 この関数はスレッド セーフではありません。

同一のネットワークがキーなしでデバイスに既に格納されている場合、この関数は失敗します。 エラー セクション (EEXIST) を参照してください。 ただし、保存されたネットワークに同じ SSID と共にキーが含まれている場合、この機能は成功し、ネットワークを格納します。

int WifiConfig_StoreOpenNetwork(const uint8_t * ssid, size_t ssidLength);

パラメーター

• ssid Wi-Fi ネットワークを識別する未指定の文字エンコーディングを持つ SSID バイト配列へのポインター。

• ssidLength Wi-Fi ネットワークの SSID 内のバイト数。

エラー

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

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

• EEXIST: 同じ SSID を持ち、キーがまだ存在しない、保存された Wi-Fi ネットワーク。

• EFAULT: は ssid NULL です。

• ERANGE: が ssidLength 0 以上WIFICONFIG_SSID_MAX_LENGTH。

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

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

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

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

戻り値

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

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

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