qwf_wifi_UpdateAccessPoint()

Updated: April 19, 2023

Update the profile settings for the access point in use

Synopsis:

#include <qwf/qwf_wifi.h>
qwf_wifi_Results_e qwf_wifi_UpdateAccessPoint(qwf_Context_t *pCtx,
                                              qwf_wifi_Ssid_t *pSsid,
                                              qwf_wifi_SecurityProtocol_e authProtocol,
                                              uint16_t maxClients,
                                              qwf_wifi_Standard_e standard,
                                              qwf_wifi_FrequencyBand_e band,
                                              bool privacy,
                                              uint16_t dhcpLeaseTime,
                                              char *pGatewayIpAddress,
                                              char *pGatewaySubnet)

Arguments:

pCtx
A pointer to the QWF service context
pSsid
A pointer to a qwf_wifi_Ssid_t structure containing the SSID of the access point
authProtocol
A qwf_wifi_SecurityProtocol_e constant specifying the new authentication protocol to use
maxClients
The new maximum number of clients to allow on the access point. Currently, 8 is the upper limit.
standard
A qwf_wifi_Standard_e constant specifying the new Wi-Fi standard to use
band
A qwf_wifi_FrequencyBand_e constant specifying the new frequency band to use
privacy
Whether clients will be prevented from seeing other connected clients
dhcpLeaseTime
The new DHCP Lease Time, in minutes, which defines how long before a DHCP-assigned IP address needs to be renewed
pGatewayIpAddress
A string containing the DHCP gateway's updated IP Address
pGatewaySubnet
A string containing the DHCP gateway's updated subnet mask

Library:

qwf_interface

Description:

This function updates the profile settings for the access point in use by the Wi-Fi Manager service for remote client connections.

Before calling this function, the client application must set all parameters needed for authentication, by calling the following functions as needed:

You can further configure the access point by specifying optional hostapd parameters with qwf_wifi_SetHostapdOptions().

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_NOT_EXISTS The access point doesn't exist

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