Share via

RasEapBegin

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function is called by RAS to initiate an authentication session.

Syntax

DWORD(*RasEapBegin)(
  VOID** ppWorkBuffer, 
  PPP_EAP_INPUT* pPppEapInput
);

Parameters

  • ppWorkBuffer
    [out] Pointer to a pointer that forwards data to a work buffer. The contents of the buffer are used only by the authentication protocol. RAS passes a pointer to this buffer to the authentication protocol in subsequent calls to the RasEapMakeMessage function.
  • pPppEapInput
    [in] Pointer to a PPP_EAP_INPUT structure that specifies initialization information for the authentication session.

Return Value

If the function call succeeds, the return value is NO_ERROR.

If the function call fails, it returns an appropriate error code from Winerror.h, Raserror.h, or Mprerror.h.

Remarks

The RasEapBegin function is not part of the RRAS application programming interface (API); it is implemented in the EAP dynamic-link library (DLL). When RAS calls the RasEapGetInfo function, it receives a PPP_EAP_INFO structure for the authentication protocol. This structure contains a pointer to the RasEapBegin function.

The memory for the work buffer, pointed to by the ppWorkBuffer parameter, is allocated by the authentication protocol. The authentication protocol should free this memory in its implementation of the RasEapEnd function.

Note

This function is called by the EAP module, not by the application. Therefore, no link library is exposed. For more information, see EAP Implementation Details.

Requirements

Header raseapif.h
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note This function is called by the EAP module, not by the application. Therefore, no link library is exposed. For more information see EAP Implementation Details.

See Also

Reference

RasEapEnd
RasEapGetInfo
RasEapMakeMessage
PPP_EAP_INFO
PPP_EAP_INPUT