次の方法で共有


WifiConfig_GetStoredNetworks関数

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

デバイスに格納されているすべての Wi-Fi ネットワークを取得します。 この関数はスレッド セーフではありません。

メモ

WifiConfig_GetStoredNetworksを呼び出す前に、WifiConfig_GetStoredNetworkCountを呼び出し、パラメーターとして渡されるWifiConfig_StoredNetwork配列の配列サイズとして結果をstoredNetworkArray使用する必要があります。

  • が小さすぎて格納されているすべての Wi-Fi ネットワークを保持できる場合 storedNetworkArray 、この関数は配列を埋め、配列要素の数を返します。

  • WiFiConfig 機能が存在しない場合、関数は空の配列を返します。

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

パラメーター

  • storedNetworkArray 格納されている Wi-Fi ネットワークを返す配列へのポインター。

  • storedNetworkArrayCount 保持できる要素 storedNetworkArray の数。 配列には、格納されているネットワークごとに 1 つの要素 Wi-Fi 必要があります。

エラー

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

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

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

  • ERANGE: storedNetworkArrayCount パラメーターは 0 です。

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

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

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

戻り値

WifiConfig_StoredNetwork配列内の要素の数を返します。エラーの場合は -1 を返します。この場合errnoはエラー値に設定されます。

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

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