RasEapGetInfo
A version of this page is also available for
4/8/2010
This function is called by RAS to obtain a set of function pointers for a specified authentication protocol.
Syntax
DWORD RasEapGetInfo(
DWORD dwEapTypeId,
PPP_EAP_INFO* pEapInfo
);
Parameters
- dwEapTypeId
[in] Specifies the authentication protocol for which to obtain information.
- pEapInfo
[out] Pointer to a PPP_EAP_INFO structure. The structure receives members that RAS sets to identify the structure version and the authentication protocol for which function pointers are requested.
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 dynamic-link library (DLL) that implements RasEapGetInfo may support more than one authentication protocol. The dwEapTypeId parameter specifies for which authentication protocol to obtain information.
Implementations of EAP must export the RasEapGetInfo function, because RAS uses RasEapGetInfo to obtain pointers to the other authentication protocol functions.
Upon initialization, RAS calls RasEapGetInfo for each EAP DLL installed in the registry subkey.
If the function returns any value other than NO_ERROR, RAS considers the authentication protocol to be nonfunctional. RAS posts an error to the event log indicating that this protocol did not start correctly and therefore is not available.
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. |