EapPeerGetInfo (Compact 7)
3/12/2014
Obtains a set of function pointers for an implementation of the EAP peer method EapPeerGetInfo currently loaded on the EAPHost service.
Syntax
DWORD WINAPI EapPeerGetInfo(
__in EAP_TYPE* pEapType,
__out EAP_PEER_METHOD_ROUTINES* pEapInfo,
__out EAP_ERROR** ppEapError
);
Parameters
- pEapType
A pointer to an EAP_TYPE structure that contains the vendor data on the implementer of the APIs pointed to by the members of this structure.
- pEapInfo
A pointer to an EAP_PEER_METHOD_ROUTINES structure that contains the function pointers to EAP method-specific implementations of the APIs that correspond to supplicant calls made to the peer-based EAPHost.
- ppEapError
A pointer to a pointer to an EAP_ERROR structure that receives any errors raised during the execution of this function call. After using the error data, this memory must be freed by calling EapPeerFreeErrorMemory.
Remarks
Every EAP peer method DLL must implement the following APIs:
- EapPeerInitialize
Initializes an EAP peer method for EAPHost.
- EapPeerBeginSession
Starts an EAP authentication session on the peer EAPHost by using the EAP method.
- EapPeerGetIdentity
Returns the user data and user identity after being called by EAPHost.
- EapPeerSetCredentials
Supplies new or updated authentication credentials to the EAP method.
- EapPeerProcessRequestPacket
Processes a packet received by EAPHost from a supplicant.
- EapPeerGetResponsePacket
Obtains a response packet from the EAP method.
- EapPeerGetResult
Obtains the result of an authentication session from the EAP method.
- EapPeerGetUIContext
Obtains the user interface context from the EAP method.
- EapPeerSetUIContext
Provides a user interface context to the EAP method.
- EapPeerGetResponseAttributes
Obtains an array of EAP response attributes from the EAP method.
- EapPeerSetResponseAttributes
Provides an updated array of EAP response attributes to the EAP method.
- EapPeerEndSession
Ends an EAP authentication session for the EAP method.
- EapPeerShutdown
Shuts down the EAP method and prepares to unload its corresponding DLL.
These APIs correspond to calls made by a supplicant, and serve as a proxy between the supplicant's API calls and the public APIs exposed on the EAP method DLL. Therefore, when a supplicant makes a call to a peer-based EAPHost to establish an authentication session or to perform an operation during that session, the EAPHost calls the corresponding implemented function on the EAP method DLL with the parameters provided. The EAP method functions are managed by pointers to their respective entry points.
The other functions in the EAP Peer Method API set are called by a peer-based EAPHost without a corresponding supplicant call, and are used for connection validation or user interface invocation operations.
This call is performed by a peer-based EAPHost by using a function pointer to this API. This API must be implemented on the EAP method loaded by EAPHost, and must strictly comply with the syntax and parameter types that are specified in the documentation.