次の方法で共有


WifiConfig_StoreWpa2Network関数

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

大事な

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

事前共有キーを使用する WPA2 Wi-Fi ネットワークを格納します。 この関数はスレッド セーフではありません。

メモ

同じ SSID と事前共有キーを持つネットワークが既に格納されている場合、この関数は失敗します。 エラー セクション (EEXIST) を参照してください。

int WifiConfig_StoreWpa2Network(const uint8_t * ssid, size_t ssidLength, const char * psk, size_t pskLength);

パラメーター

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

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

  • psk Wi-Fi ネットワークの事前共有キーを含むバッファーへのポインター。

  • pskLength Wi-Fi ネットワークの事前共有キーの長さ。

エラー

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

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

  • EEXIST: 同じ SSID を持ち、WPA2 を使用する、保存された Wi-Fi ネットワークが既に存在します。

  • EFAULT: または ssidpsk が NULL です。

  • ERANGE: ssidLength または pskLength パラメーターが 0 以上 WIFICONFIG_SSID_MAX_LENGTH であり、 です WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE

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

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

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

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

戻り値

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

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

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