qwf_wifi_UpdateAccessPoint()

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 created by qwf_Init()
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:

qwf_wifi_SetPassphrase(), for the WPA-PSK and WPA2-PSK authentication protocols
qwf_wifi_SetWepKey(), for WEP authentication
qwf_wifi_SetEnterpriseCredentials(), for WPA-EAP or WPA2-EAP authentication

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

Returns:

WIFI_OK Successful result

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

WIFI_ERR_NOT_EXISTS The access point doesn't exist

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