Share via

WifiConfig_ReloadConfig function

  • Article

Header: #include <applibs/wificonfig.h>

Reloads the current network configuration from nonvolatile storage. Any unsaved configuration will be lost.

static int WifiConfig_ReloadConfig(void);

Errors

Returns -1 if an error is encountered and sets errno to the error value.

  • EACCES: the application manifest doesn't include the WifiConfig capability.

  • EAGAIN: the Wi-Fi device isn't ready.

  • ENETDOWN: the Wi-Fi network interface is unavailable.

Any other errno may also be specified; such errors aren't deterministic and the same behavior might not be retained through system updates.

Return value

Returns 0 for success, or -1 for failure, in which case errno is set to the error value.

Remarks

Applications must call WifiConfig_ReloadConfig to reload certificates used for EAP-TLS if new certificates have been installed using the CertStore APIs. The function disconnects all current Wi-Fi connections and restarts the connection process. It does not write the configuration to persistent storage; it merely reloads the existing configuration from storage. To save a configuration so that it persists across reboots, call WifiConfig_PersistConfig.

Application manifest requirements

The application manifest must include the WifiConfig capability.