struttura PPP_EAP_INFO (raseapif.h)

Articolo
03/05/2024

La struttura PPP_EAP_INFO fornisce informazioni al Gestione connessioni sul protocollo di autenticazione, inclusi i puntatori alle funzioni che si trovano nella DLL EAP.

Sintassi

typedef struct _PPP_EAP_INFO {
  DWORD  dwSizeInBytes;
  DWORD  dwEapTypeId;
  DWORD( )(BOOL fInitialize) *RasEapInitialize;
  DWORD(VOID **ppWorkBuffer,PPP_EAP_INPUT *pPppEapInput) * )(RasEapBegin;
  DWORD()(VOID *pWorkBuffer) * RasEapEnd;
  DWORD(ID *pWorkBuf,PPP_EAP_PACKET *pReceivePacket,PPP_EAP_PACKET *pSendPacket,DWORD cbSendPacket,PPP_EAP_OUTPUT *pEapOutput,PPP_EAP_INPUT *pEapInput) * )(VORasEapMakeMessage;
} PPP_EAP_INFO, *PPPP_EAP_INFO;

Members

dwSizeInBytes

Specifica le dimensioni della struttura PPP_EAP_INFO . RAS passa questo valore alla DLL EAP. La DLL usa questo valore per determinare quale versione della struttura PPP_EAP_INFO ras usa.

dwEapTypeId

Specifica un protocollo di autenticazione specifico. Questo identificatore deve essere univoco in tutta l'implementazione a livello di settore di EAP. L'implementatore di un protocollo di autenticazione deve ottenere questo identificatore dall'autorità IANA (Internet Assigned Numbers Authority).

RasEapInitialize

Puntatore alla funzione RasEapInitialize per il protocollo di autenticazione. Il protocollo di autenticazione imposta il valore di questo membro. Il protocollo di autenticazione può impostare questo membro su NULL, nel qual caso il protocollo non richiede RAS per chiamare questa funzione.

fInitialize

Specifica se il protocollo di autenticazione deve inizializzare o annullare l'inizializzazione. Questo parametro è TRUE se il protocollo inizializza e FALSE se il protocollo non viene inizializzato.

RasEapBegin

Puntatore alla funzione RasEapBegin per il protocollo di autenticazione richiesto. Il protocollo di autenticazione imposta il valore di questo membro. Questo membro può essere NULL, nel qual caso il protocollo di autenticazione non richiede alcuna inizializzazione. Se questo membro è NULL, RAS ignora il membro RasEapEnd .

ppWorkBuffer

Puntatore a un puntatore che, in caso di esito positivo, punta a un buffer di lavoro. Questo buffer è opaco a RAS; il contenuto del buffer viene usato solo dal protocollo di autenticazione. La gestione connessione RAS passa un puntatore a questo buffer al protocollo di autenticazione nelle chiamate successive a RasEapMakeMessage.

pPppEapInput

Puntatore a una struttura PPP_EAP_INPUT che specifica le informazioni di inizializzazione per la sessione di autenticazione.

RasEapEnd

Puntatore alla funzione RasEapEnd per il protocollo di autenticazione. Il protocollo di autenticazione imposta il valore di questo membro.

pWorkBuffer

Puntatore al buffer di lavoro da liberare.

RasEapMakeMessage

Puntatore alla funzione RasEapMakeMessage per il protocollo di autenticazione richiesto. Il protocollo di autenticazione imposta il valore di questo membro.

pWorkBuf

Puntatore al buffer di lavoro. Il protocollo di autenticazione fornisce ras con un puntatore a questo buffer tramite la funzione RasEapBegin .

pReceivePacket

Puntatore a una struttura PPP_EAP_PACKET che contiene un pacchetto ricevuto. Un valore pReceivePacketnull indica che RAS sta avviando la finestra di dialogo con il protocollo di autenticazione oppure che si è verificato un timeout e che il protocollo di autenticazione deve inviare nuovamente l'ultimo pacchetto. Il protocollo di autenticazione deve determinare, in base al contesto, quale di questi due casi è vero.

pSendPacket

Puntatore a una struttura PPP_EAP_PACKET . Il protocollo di autenticazione può usare questa struttura per specificare un pacchetto da inviare.

cbSendPacket

Specifica le dimensioni, in byte, del buffer a cui punta pSendPacket.

pEapOutput

Puntatore a una struttura PPP_EAP_OUTPUT .

pEapInput

Puntatore a una struttura PPP_EAP_INPUT . Questo parametro può essere NULL.

Commenti

Una dll EAP specifica può implementare più di un protocollo di autenticazione. Utilizzare il membro dwEapTypeId per specificare il protocollo da recuperare.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	raseapif.h