RasEapInitialize callback function

The RAS connection manager calls the RasEapInitialize function to initialize or de-initialize the authentication protocol.

Syntax

DWORD APIENTRY RasEapInitialize(
  _In_ BOOL fInitialize
);

Parameters

  • fInitialize [in]
    Specifies whether the authentication protocol should initialize or de-initialize. This parameter is TRUE if the protocol initializes and FALSE if the protocol does not initialize.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value should be an appropriate error code from Winerror.h, Raserror.h, or Mprerror.h.

Remarks

The RasEapInitialize function is not part of the RRAS API; it is implemented in the EAP DLL. When the Connection Manager calls the RasEapGetInfo function, it receives a PPP_EAP_INFO structure for the authentication protocol. This structure contains a pointer to the RasEapInitialize function.

The authentication protocol may set the RasEapInitialize member in PPP_EAP_INFO to NULL. A NULL value indicates that the authentication protocol does not require initialization or de-initialization. Therefore, RAS need not call this function.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Raseapif.h

See also

Extensible Authentication Protocol Reference

EAP Functions

PPP_EAP_INFO

RasEapBegin

RasEapGetInfo