qwf_wifi_StartScan()

Updated: April 19, 2023

Start a scan of available Wi-Fi access points

Synopsis:

#include <qwf/qwf_wifi.h>
qwf_wifi_Results_e qwf_wifi_StartScan(qwf_Context_t *pCtx)

Arguments:

pCtx
A pointer to the QWF service context

Library:

qwf_interface

Description:

This function starts a scan of available Wi-Fi access points. The scan is asynchronous, so the function returns immediately with a result indicating whether the scan has started. The WIFI_EVENT_SCAN_RESULTS_AVAILABLE event is generated when the scan is complete, typically after several seconds. When it has received this event, the client can query the results using qwf_wifi_GetScanResults().

Returns:

WIFI_OK Successful result

WIFI_ERR_INACTIVE The QWF Wi-Fi Manager service is inactive or not ready

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

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