DOT11EXT_SET_CURRENT_PROFILE callback function (wlanihv.h)
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) |