Export (0) Print
Expand All
Expand Minimize
0 out of 3 rated this helpful - Rate this topic

WlanHostedNetworkForceStop function

The WlanHostedNetworkForceStop function transitions the wireless Hosted Network to the wlan_hosted_network_idle without associating the request with the application's calling handle.

Syntax


DWORD WINAPI WlanHostedNetworkForceStop(
  _In_        HANDLE hClientHandle,
  _Out_opt_   PWLAN_HOSTED_NETWORK_REASON pFailReason,
  _Reserved_  PVOID pvReserved
);

Parameters

hClientHandle [in]

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

pFailReason [out, optional]

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

pvReserved

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 codeDescription
ERROR_INVALID_HANDLE

A handle is invalid. This error is returned if the handle specified in the hClientHandle parameter was not found in the handle table.

ERROR_INVALID_PARAMETER

A parameter is incorrect. This error is returned if any of the following conditions occur:

  • hClientHandle is NULL.
  • pvReserved is not NULL.
ERROR_INVALID_STATE

The resource is not in the correct state to perform the requested operation.

ERROR_SERVICE_NOT_ACTIVE

The service has not been started. This error is returned if the WLAN AutoConfig Service is not running.

Other

Various RPC and other error codes. Use FormatMessage to obtain the message string for the returned error.

 

Remarks

The WlanHostedNetworkForceStop 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 WlanHostedNetworkForceStop function to force the stop the Hosted Network and transition the wireless Hosted Network to the wlan_hosted_network_idle without associating the request with the application's calling handle. A client typically calls the WlanHostedNetworkForceStop function to match an earlier successful call to the WlanHostedNetworkForceStart function.

The WlanHostedNetworkForceStop function could fail if Hosted Network state is not wlan_hosted_network_active.

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.

An application might call the WlanHostedNetworkForceStop function to stop the Hosted Network after a previous call to the WlanHostedNetworkForceStart by an elevated system user that accepted the increased power requirements involved in running the wireless Hosted Network for extended durations.

Any user can call the WlanHostedNetworkForceStop function to force the stop of 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.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

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
WLAN_HOSTED_NETWORK_REASON
WLAN_SECURABLE_OBJECT
WlanCloseHandle
WlanEnumInterfaces
WlanOpenHandle
WlanHostedNetworkForceStart
WlanHostedNetworkQueryStatus
WlanHostedNetworkStartUsing
WlanHostedNetworkStopUsing

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.