qwf_wifi_GetSavedNetworks()

Query the current Saved Network profiles

Synopsis:

#include <qwf/qwf_wifi.h>

qwf_wifi_Results_e qwf_wifi_GetSavedNetworks(qwf_Context_t *pCtx,
                               uint16_t *const pNumEntries,
                               qwf_wifi_SavedNetwork_t *const pNetworks);

Arguments:

pCtx: A pointer to the QWF service context created by qwf_Init()
pNumEntries: A pointer to an unsigned 16-bit integer that initially specifies the number of profile entries requested. The function updates this variable with the number of entries written into pNetworks. The new value represents the number of stored network profiles and may be less than what was requested.
pNetworks: A pointer to memory for storing an array of qwf_wifi_SavedNetwork_t objects, which will contain data for individual profiles

Library:

qwf_interface

Description:

This function queries the Wi-Fi Manager service for the current Saved Network profiles. The function writes an array of qwf_wifi_SavedNetwork_t objects into the space pointed to by pNetworks; these objects store the profile data.

The client must allocate enough array memory to store the number of entries requested by pNumEntries. The function updates this variable so it contains the actual number of array entries written.

An application should call this function after the device's power is cycled because the profile IDs may have changed based on the profile additions and deletions done in the last power cycle.

Returns:

WIFI_OK Successful result

WIFI_ERR_PARAM A pointer argument is NULL, or the QWF Wi-Fi Manager context can't be retrieved

WIFI_ERR_INT The QWF Wi-Fi Manager service couldn't issue the request or read the response