estructura de PPP_EAP_INFO (raseapif.h)
La estructura de PPP_EAP_INFO proporciona información al Administrador de conexiones sobre el protocolo de autenticación, incluidos los punteros a las funciones ubicadas en el archivo DLL de EAP.
Sintaxis
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;
Miembros
dwSizeInBytes
Especifica el tamaño de la estructura PPP_EAP_INFO . RAS pasa este valor al archivo DLL de EAP. El archivo DLL usa este valor para determinar qué versión de la estructura de PPP_EAP_INFO ras usa.
dwEapTypeId
Especifica un protocolo de autenticación determinado. Este identificador debe ser único en toda la implementación del sector de EAP. El implementador de un protocolo de autenticación debe obtener este identificador de la autoridad de números asignados a Internet (IANA).
RasEapInitialize
Puntero a la función RasEapInitialize para el protocolo de autenticación. El protocolo de autenticación establece el valor de este miembro. El protocolo de autenticación puede establecer este miembro en NULL, en cuyo caso el protocolo no requiere RAS para llamar a esta función.
fInitialize
Especifica si el protocolo de autenticación debe inicializarse o desa inicializarse. Este parámetro es TRUE si el protocolo inicializa y FALSE si el protocolo no se inicializa.
RasEapBegin
Puntero a la función RasEapBegin para el protocolo de autenticación solicitado. El protocolo de autenticación establece el valor de este miembro. Este miembro puede ser NULL, en cuyo caso, el protocolo de autenticación no requiere ninguna inicialización. Si este miembro es NULL, RAS omite el miembro RasEapEnd .
ppWorkBuffer
Puntero a un puntero que, al devolverse correctamente, apunta a un búfer de trabajo. Este búfer es opaco para RAS; el contenido del búfer solo lo usa el protocolo de autenticación. El administrador de conexiones RAS pasa un puntero a este búfer al protocolo de autenticación en llamadas posteriores a RasEapMakeMessage.
pPppEapInput
Puntero a una estructura de PPP_EAP_INPUT que especifica información de inicialización para la sesión de autenticación.
RasEapEnd
Puntero a la función RasEapEnd para el protocolo de autenticación. El protocolo de autenticación establece el valor de este miembro.
pWorkBuffer
Puntero al búfer de trabajo que se va a liberar.
RasEapMakeMessage
Puntero a la función RasEapMakeMessage para el protocolo de autenticación solicitado. El protocolo de autenticación establece el valor de este miembro.
pWorkBuf
Puntero al búfer de trabajo. El protocolo de autenticación proporciona a RAS un puntero a este búfer a través de la función RasEapBegin .
pReceivePacket
Puntero a una estructura de PPP_EAP_PACKET que contiene un paquete recibido. Un valor pReceivePacket de NULL indica que RAS está iniciando el cuadro de diálogo con el protocolo de autenticación, o que se ha producido un tiempo de espera y el protocolo de autenticación debe volver a enviar el último paquete. El protocolo de autenticación debe determinar, en función del contexto, cuál de estos dos casos es true.
pSendPacket
Puntero a una estructura de PPP_EAP_PACKET . El protocolo de autenticación puede usar esta estructura para especificar un paquete que se va a enviar.
cbSendPacket
Especifica el tamaño, en bytes, del búfer al que apunta pSendPacket.
pEapOutput
Puntero a una estructura de PPP_EAP_OUTPUT .
pEapInput
Puntero a una estructura de PPP_EAP_INPUT . Este parámetro puede ser NULL.
Comentarios
Un archivo DLL de EAP determinado puede implementar más de un protocolo de autenticación. Use el miembro dwEapTypeId para especificar para qué protocolo se va a recuperar información.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
Encabezado | raseapif.h |