wifi_get_scan_results()

#include <wifi/wifi_service.h>
 

WIFI_API wifi_result_t wifi_get_scan_results(wifi_scan_results_t **scan_results, wifi_scan_report_t *report_type, int *num_scan_entries)

Since:

BlackBerry 10.2.0

Arguments:

scan_results

Pointer that will be set to the scan result list.

report_type

The report type for these results.

num_scan_entries

The number of list entries.

Library:

libwifi (For the qcc command, use the -l wifi option to link against this library)

Description:

This function queries the latest available scan results list as well as the size of the list. It should be called after a scan result event notification is received to retrieve the scan result list. The wifi_free_scan_results() function must be called to free the scan results when scan results processing is complete.

The scan result entries can be decoded by looping from 1 to num_scan_entries and calling one of the functions prefixed with wifi_get_scan_result_ to extract the details of each scan result entry.

Returns:

A return code from wifi_result_t.