NotificationHandler callback function (eappapis.h)

  • Article

A callback prototype that notifies the supplicant that there is a change in the Statement of Health (SoH) and re-authentication of a Network Access Protection (NAP) system connection is required. For the user to receive visual notification of a change in the SoH, the callback must remain in place until after authentication is complete.

Note  Never cancel the callback while re-authentication is in progress and the network connection is still valid. Never attempt to use any other mechanism to notify the supplicant that the SoH has changed.
 

Syntax

NotificationHandler Notificationhandler;

void Notificationhandler(
  [in] GUID connectionId,
  [in] void *pContextData
)
{...}

Parameters

[in] connectionId

A GUID provided by the supplicant to EAPHost. This value specifies the logical network connection to re-authenticate.

[in] pContextData

Context data provided to EAPHost by the supplicant. This context data can be used by the supplicant for re-authentication.

Return value

None

Remarks

A pointer to this callback function must be provided when calling EapHostPeerBeginSession. The callback may be called by EAPHost at any time prior to calling EapHostPeerClearConnection.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header eappapis.h

See also

EAPHost Supplicant Callbacks