共用方式為

WifiConfig_GetStoredNetworks函數

  • 發行項

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

擷取裝置上所有儲存 Wi-Fi 網路。 此函數並不安全對話。

注意

在呼叫 WifiConfig_GetStoredNetworks之前，您必須呼叫 WifiConfig_GetStoredNetworkCount ，並使用結果做為傳入為參數 之WifiConfig_StoredNetwork數 組的 storedNetworkArray 陣列大小。

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

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

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

參數

  • storedNetworkArray 傳回儲存 Wi-Fi 網路之陣列的指標。

  • storedNetworkArrayCount 可以保留的元素 storedNetworkArray 數目。 陣列每個儲存的 Wi-Fi 網路應有一個元素。

錯誤

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

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

  • EFAULT：參數 storedNetworkArray 為 Null。

  • ERANGE：參數 storedNetworkArrayCount 為 0。

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

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

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

傳回值

傳回 WifiConfig_StoredNetwork 陣列中的元素個數，或是 -1 代表失敗，在這種情況下 errno 會設定為錯誤值。

應用程式資訊清單需求

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