Funzione EapPeerGetInfo (eapmethodpeerapis.h)

Ottiene un set di puntatori a funzione per un'implementazione del metodo peer EapPeerGetInfo EapPeerGetInfo attualmente caricato nel servizio EAPHost.

Sintassi

DWORD EapPeerGetInfo(
  [in]  EAP_TYPE                 *pEapType,
  [out] EAP_PEER_METHOD_ROUTINES *pEapInfo,
  [out] EAP_ERROR                **ppEapError
);

Parametri

[in] pEapType

Puntatore a una struttura EAP_TYPE che contiene i dati del fornitore sull'implementatore delle API a cui puntano i membri di questa struttura.

[out] pEapInfo

Puntatore a una struttura EAP_PEER_METHOD_ROUTINES che contiene i puntatori a funzioni alle implementazioni specifiche del metodo EAP delle API che corrispondono a chiamate suppliche effettuate all'EAPHost basato su peer.

[out] ppEapError

Puntatore a un puntatore a una struttura EAP_ERROR che riceve eventuali errori generati durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata chiamando EapPeerFreeErrorMemory.

Valore restituito

nessuno

Osservazioni

Ogni DLL del metodo peer EAP deve implementare le API seguenti:

• EapPeerInitialize
• EapPeerBeginSession
• EapPeerGetIdentity
• EapPeerSetCredentials
• EapPeerProcessRequestPacket
• EapPeerGetResponsePacket
• EapPeerGetResult
• EapPeerGetUIContext
• EapPeerSetUIContext
• EapPeerGetResponseAttributes
• EapPeerSetResponseAttributes
• EapPeerEndSession
• EapPeerShutdown

Queste API corrispondono alle chiamate effettuate da un supplicante e fungono da proxy tra le chiamate API di supplicante e le API pubbliche esposte nella DLL del metodo EAP. Pertanto, quando un supplicante effettua una chiamata a un EAPHost basato su peer per stabilire una sessione di autenticazione o per eseguire un'operazione durante tale sessione, EAPHost chiama la funzione implementata corrispondente nella DLL del metodo EAP con i parametri forniti. Le funzioni del metodo EAP vengono gestite dai puntatori ai rispettivi punti di ingresso.

Le altre funzioni nel set di API del metodo peer EAP vengono chiamate da un EAPHost basato su peer senza una chiamata supplica corrispondente e vengono usate per le operazioni di convalida della connessione o chiamata all'interfaccia utente.

Questa chiamata viene eseguita da un EAPHost basato su peer usando un puntatore a funzione a questa API. Questa API deve essere implementata nel metodo EAP caricato da EAPHost e deve essere strettamente conforme alla sintassi e ai tipi di parametro specificati nella documentazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	eapmethodpeerapis.h

Vedi anche

Funzioni di Run-Time del metodo peer EAPHost