Share via

EapHostPeerSetUIContext (Compact 2013)

  • Article

3/26/2014

Provides a new or updated user interface context to the EAP peer method loaded on EAPHost after the UI has been raised. For more information about raising the UI, see EapHostPeerGetUIContext.

EapHostPeerSetUIContext sets the UI context data that was received from a call to EapHostPeerInvokeInteractiveUI.

Syntax

DWORD APIENTRY EapHostPeerSetUIContext(
  __in   EAP_SESSIONID sessionHandle,
  __in   DWORD dwSizeOfUIContextData,
  __in   const BYTE* pUIContextData,
  __out  EapHostPeerResponseAction* pEapOutput,
  __out  EAP_ERROR** ppEapError
);

Parameters

  • sessionHandle
    A pointer to an EAP_SESSIONID structure that contains the unique handle for this EAP authentication session on the EAPHost server. This handle is returned in the pSessionId parameter in a previous call to EapHostPeerBeginSession.
  • dwSizeOfUIContextData
    The size, in bytes, of the user interface context data buffer provided in pUIContextData.
  • pUIContextData
    A pointer to a byte buffer that contains the new supplicant UI context data to be set on EAPHost. The data is returned from the EapHostPeerInvokeInteractiveUI OUT parameter.
  • pEapOutput
    A pointer to an EapHostPeerResponseAction enumeration value that specifies the action code for the next step the supplicant must take as a response.
  • ppEapError
    A pointer to the address of an EAP_ERROR structure. The address should be set to NULL before the code calls this function. If error data is available, a pointer to the address of an EAP_ERROR structure that contains any errors raised during the execution of this function call is received. After using the error data, free this memory by calling EapHostPeerFreeEapError.

See Also

Reference

EAPHost Supplicant Run-time Functions
EapHostPeerGetUIContext
EapHostPeerInvokeInteractiveUI