WlanHostedNetworkRefreshSecuritySettings function (wlanapi.h)

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


DWORD WlanHostedNetworkRefreshSecuritySettings(
  HANDLE                      hClientHandle,
  PVOID                       pvReserved



The client's session handle, returned by a previous call to the WlanOpenHandle function.


An optional pointer to a value that receives the failure reason, if the call to the WlanHostedNetworkRefreshSecuritySettings function fails. Possible values for the failure reason are from the WLAN_HOSTED_NETWORK_REASON enumeration type defined in the Wlanapi.h header file.


Reserved for future use. This parameter must be NULL.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value may be one of the following return codes.

Return code Description
A handle is invalid. This error is returned if the handle specified in the hClientHandle parameter was not found in the handle table.
A parameter is incorrect. This error is returned if any of the following conditions occur:
  • hClientHandle is NULL.
  • pvReserved is not NULL.
The resource is not in the correct state to perform the requested operation.
The service has not been started. This error is returned if the WLAN AutoConfig Service is not running.
Various RPC and other error codes. Use FormatMessage to obtain the message string for the returned error.


The WlanHostedNetworkRefreshSecuritySettings function is an extension to native wireless APIs added to support the wireless Hosted Network on Windows 7 and on Windows Server 2008 R2 with the Wireless LAN Service installed.

A client application calls the WlanHostedNetworkRefreshSecuritySettings function 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 WlanHostedNetworkRefreshSecuritySettings function 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 wlan_hosted_network_idle if it was currently running (wlan_hosted_network_active).

Note  Any network clients (PCs or devices) on the wireless Hosted Network would have to be re-configured after calling the WlanHostedNetworkRefreshSecuritySettings function 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 WlanHostedNetworkRefreshSecuritySettings function does not change or reset the secondary key.
Any Hosted Network state change caused by this function would not be automatically undone if the calling application closes its calling handle (by calling WlanCloseHandle with the hClientHandle parameter) or if the process ends.

Any user can call the WlanHostedNetworkRefreshSecuritySettings function to refresh the security settings on the Hosted Network. However, the ability to enable the wireless Hosted Network may be restricted by group policy in a domain.

On Windows 7 and later, the operating system installs a virtual device if a Hosted Network capable wireless adapter is present on the machine. This virtual device normally shows up in the “Network Connections Folder” as ‘Wireless Network Connection 2’ with a Device Name of ‘Microsoft Virtual WiFi Miniport adapter’ if the computer has a single wireless network adapter. This virtual device is used exclusively for performing software access point (SoftAP) connections and is not present in the list returned by the WlanEnumInterfaces function. The lifetime of this virtual device is tied to the physical wireless adapter. If the physical wireless adapter is disabled, this virtual device will be removed as well. This feature is also available on Windows Server 2008 R2 with the Wireless LAN Service installed.


Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header wlanapi.h (include Wlanapi.h)
Library Wlanapi.lib
DLL Wlanapi.dll

See also

About the Wireless Hosted Network

Using Wireless Hosted Network and Internet Connection Sharing