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.
DWORD APIENTRY Dot11ExtSetCurrentProfile( _In_opt_ HANDLE hDot11SvcHandle, _In_opt_ HANDLE hConnectSession, _In_opt_ PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile, _In_opt_ PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile );
- hDot11SvcHandle [in, optional]
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.
- hConnectSession [in, optional]
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.
- pIhvConnProfile [in, optional]
A pointer to a DOT11EXT_IHV_CONNECTIVITY_PROFILE structure that contains connectivity settings for the IHV profile.
- pIhvSecProfile [in, optional]
A pointer to a DOT11EXT_IHV_SECURITY_PROFILE structure that specifies security settings for the IHV profile.
If the call succeeds, the function returns ERROR_SUCCESS. Otherwise, it returns an error code defined in Winerror.h.
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.
|Available in Windows Vista and later versions of the Windows operating systems.|
Build date: 12/9/2013