共用方式為

WifiConfig_GetScannedNetworks函數

  • 發行項

頁首： #include < applibs/wificonfig.h>

取得上次掃描工作找到的 Wi-Fi 網路。 此函數並不安全對話。

  • 如果 scannedNetworkArray 太小而無法保存所有網路，此函數會填滿所有元素，並傳回陣列元素的數量。

  • 如果沒有 WiFiConfig 功能，則函數會傳回空白陣列。

ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

參數

  • scannedNetworkArray 傳回擷取 Wi-Fi 網路之陣列的指標。

  • scannedNetworkArrayCount 掃描的NetworkArray 可以保留的元素數目。 陣列應該會有上一個掃描工作所找到的每個 Wi-Fi 網路的一個元素。

錯誤

如果發生錯誤並設定為 errno 錯誤值，則傳回 -1。

  • EACCES：應用程式資訊清單不包含 WifiConfig 功能。

  • EFAULT：參數 scannedNetworkArray 為 Null。

  • ERANGE：參數 scannedNetworkArrayCount 為 0。

  • EINVAL： scannedNetworkArray 參數或其結構版本無效。

  • EAGAIN：Wi-Fi 裝置尚未準備就緒。

您也可以指定任何其他 errno 錯誤;這類錯誤不是不確定的，同樣的行為可能無法透過系統更新來保留。

傳回值

傳回 scannedNetworkArray 傳回 的WifiConfig_ScannedNetwork 元素數目，或是 -1 為失敗，在這種情況下 errno 會設為錯誤值。

應用程式資訊清單需求

應用程式 資訊清單 必須包含 WifiConfig 功能。