次の方法で共有

WifiConfig_GetScannedNetworks関数

  • [アーティクル]

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

最後のスキャン操作で検出された Wi-Fi ネットワークを取得します。 この関数はスレッド セーフではありません。

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

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

ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

パラメーター

  • scannedNetworkArray 取得した Wi-Fi ネットワークを返す配列へのポインター。

  • scannedNetworkArrayCount scannedNetworkArray が保持できる要素の数。 配列には、最後のスキャン操作で検出されたネットワーク Wi-Fi ごとに 1 つの要素が必要です。

エラー

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

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

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

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

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

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

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

戻り値

scannedNetworkArray によって返される WifiConfig_ScannedNetwork 要素の数を返します。エラーの場合は -1 を返します。この場合 errno はエラー値に設定されます。

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

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