WiFi Framework C++ Edition

◆ RefreshSecuritySettings()

int RefreshSecuritySettings ( )

The function refreshes the configurable and auto-generated parts of the wireless Hosted Network security settings.

Returns
If the function succeeds, the return value is wclCommon::WCL_E_SUCCESS. If the function fails, the return value may be one of the WCL return codes.

A client application calls the RefreshSecuritySettings method to force a refresh of the configurable and auto-generated parts of the security settings (the primary key) on the wireless Hosted Network.

An application might call the RefreshSecuritySettings method after ensuring that the user accepts the impact of updating the security settings. In order to succeed, this function must persist the new settings which would require that Hosted Network state be transitioned to hnIdle if it was currently running (hnActive).

Any network clients (PCs or devices) on the wireless Hosted Network would have to be re-configured after calling the RefreshSecuritySettings method if their continued usage is a goal. An application would typically call this function in situations where the user feels that the security of the previous primary key used for security by the wireless Hosted Network has been violated.

Note that the RefreshSecuritySettings method does not change or reset the secondary key.