Edit

HS_PLUGIN_START_POST_CONNECT_AUTH function

Wi-Fi Hotspot Offloading deprecation note

Important

Starting in Windows 10, version 1709, the Wi-Fi Hotspot Offloading feature is deprecated and should not be used. Instead, we recommend writing a UWP app and using the Wi-Fi Hotspot Authentication API (Windows.Networking.NetworkOperators).

For a code sample and more info, see the Wi-Fi hotspot authentication sample.

The HS_PLUGIN_START_POST_CONNECT_AUTH function is called to perform any post-connect authentication required to authenticate the device over the network.

Syntax

 typedef DWORD (WINAPI *HS_PLUGIN_START_POST_CONNECT_AUTH)(
  _In_ DWORD                 dwConnectionId,
  _In_ HS_CONNECTION_CONTEXT *pConnectContext,
  _In_ HS_SIM_DATA           *pSIMData,
  _In_ HS_NETWORK_IDENTITY   *pNetworkIdentity,
  _In_ HS_NETWORK_PROFILE    *pNetworkProfile
);

Parameters

dwConnectionId [in]
Unique identifier for the network connection.

*pConnectContext [in]
Pointer to a HS_CONNECTION_CONTEXT structure that contains the information required by the plugin for post-connect authentication.

*pSIMData [in]
Pointer to a HS_SIM_DATA structure that contains information from the SIM required by the plugin for post-connect authentication.

*pNetworkIdentity [in]
Pointer to the HS_NETWORK_IDENTITY structure for the network.

*pNetworkProfile [in]
Pointer to the HS_NETWORK_PROFILE structure that contains the network profile.

Return value

This function is called by the host to communicate with the plugin and does not return a value.

Remarks

After calling this function, the plugin must call the HS_HOST_POST_CONNECT_AUTH_COMPLETION handler to inform the host of the status of the request.

If the network uses EAP-SIM/AKA authentication, the plugin is not expected to perform any activity in this state. However, if the network requires HTTP-based authentication, the plugin must perform the appropriate authentication.

Requirements

Version

Windows 10 Mobile

Header

Hotspotoffloadplugin.h (include Hotspotoffloadplugin.h)

See also

HS_CONNECTION_CONTEXT

HS_SIM_DATA

HS_NETWORK_IDENTITY

HS_NETWORK_PROFILE