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.