DOT11EXT_SET_CURRENT_PROFILE callback function (wlanihv.h)

Article
10/21/2021

Important The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.

The IHV Extensions DLL calls the Dot11ExtSetCurrentProfile function to specify the settings for the IHV-defined connectivity and security profile fragments. These fragments will be applied to the current network profile.

Syntax

DOT11EXT_SET_CURRENT_PROFILE Dot11extSetCurrentProfile;

DWORD Dot11extSetCurrentProfile(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in, optional] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
)
{...}

Parameters

[in, optional] hDot11SvcHandle

The handle used by the operating system to reference the wireless LAN (WLAN) adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.

[in, optional] hConnectSession

The handle used by the operating system to reference the connection session with the basic service set (BSS) network. This handle value was specified through a previous call to the Dot11ExtIhvPerformPreAssociate IHV Handler function.

[in, optional] pIhvConnProfile

A pointer to a DOT11EXT_IHV_CONNECTIVITY_PROFILE structure that contains connectivity settings for the IHV profile.

[in, optional] pIhvSecProfile

A pointer to a DOT11EXT_IHV_SECURITY_PROFILE structure that specifies security settings for the IHV profile.

Return value

If the call succeeds, the function returns ERROR_SUCCESS. Otherwise, it returns an error code defined in Winerror.h.

Remarks

The Dot11ExtSetCurrentProfile function allows the IHV to add custom connectivity and security profile fragments to the current network profile used for the basic service set (BSS) network connection. The profile fragments are IHV-specific and are applicable to connectivity or security extensions available to the user through the Native 802.11 IHV UI Extensions DLL.

The IHV Extensions DLL must follow these guidelines when calling the Dot11ExtSetCurrentProfile function:

The IHV Extensions DLL must only call Dot11ExtSetCurrentProfile when performing a pre-association operation initiated through a call to the Dot11ExtIhvPerformPreAssociate IHV Handler function. For more information about the pre-association operation, see Pre-Association Operation.
The IHV Extensions DLL must not call Dot11ExtSetCurrentProfile from within the call to the Dot11ExtIhvPerformPreAssociate IHV Handler function. Dot11ExtSetCurrentProfile must be called from a different thread than the one which is processing the call to Dot11ExtIhvPerformPreAssociate.

Requirements

Requirement	Value
Minimum supported client	Available in Windows Vista and later versions of the Windows operating systems.
Target Platform	Desktop
Header	wlanihv.h (include Wlanihv.h)