Partager via

Dot11ExtSetCurrentProfile (Compact 2013)

  • Article

3/26/2014

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

Syntax

DWORD WINAPI Dot11ExtSetCurrentProfile(
    HANDLE hDot11SvcHandle,
    HANDLE hConnectSession,
    PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
    PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
);

Parameters

  • hDot11SvcHandle
    [in] The handle that is 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.
  • hConnectSession
    [in] The handle that is 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.

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 apply to connectivity or security extensions that are available to the user through the Native 802.11 IHV UI Extensions DLL.

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

  • The IHV Extensions DLL must call Dot11ExtSetCurrentProfile only when it performs a pre-association operation initiated through a call to the Dot11ExtIhvPerformPreAssociate IHV Handler function.
  • The IHV Extensions DLL must not call Dot11ExtSetCurrentProfile from inside 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

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Extensibility Functions
Dot11ExtIhvInitAdapter
Dot11ExtIhvPerformPreAssociate
DOT11EXT_IHV_CONNECTIVITY_PROFILE
DOT11EXT_IHV_SECURITY_PROFILE
Native 802.11 IHV Extensions DLL