Compartir a través de

estructura EAP_AUTHENTICATOR_METHOD_ROUTINES (eapmethodauthenticatorapis.h)

  • Artículo

Contiene un conjunto de punteros de función a las API del método EAPHost Authenticator.

Sintaxis

typedef struct _EAP_AUTHENTICATOR_METHOD_ROUTINES {
  DWORD           dwSizeInBytes;
  EAP_METHOD_TYPE *pEapType;
  DWORD(EAP_METHOD_TYPE *pEapType,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorInitialize;
  DWORD(ORD dwFlags,LPCWSTR pwszIdentity, const EapAttributes * const pAttributeArray,DWORD dwSizeofConnectionData, const BYTE * const pConnectionData,DWORD dwMaxSendPacketSize,EAP_SESSION_HANDLE *pSessionHandle,EAP_ERROR **ppEapError)          * )(DWEapMethodAuthenticatorBeginSession;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD dwFlags, const WCHAR *pwszIdentity, const EapAttributes * const pAttributeArray,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorUpdateInnerMethodParams;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD cbReceivePacket, const EapPacket * const pReceivePacket,EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorReceivePacket;
  DWORD(P_SESSION_HANDLE sessionHandle,BYTE bPacketId,DWORD *pcbSendPacket,EapPacket *pSendPacket,EAP_AUTHENTICATOR_SEND_TIMEOUT *pTimeout,EAP_ERROR **ppEapError)          * )(EAEapMethodAuthenticatorSendPacket;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EapAttributes *pAttribs,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorGetAttributes;
  DWORD(AP_SESSION_HANDLE sessionHandle, const EapAttributes * const pAttribs,EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorSetAttributes;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EAP_METHOD_AUTHENTICATOR_RESULT *pResult,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorGetResult;
  DWORD((EAP_SESSION_HANDLE sessionHandle,EAP_ERROR **ppEapError)          * )EapMethodAuthenticatorEndSession;
  DWORD(EAP_METHOD_TYPE *pEapType,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorShutdown;
} EAP_AUTHENTICATOR_METHOD_ROUTINES, *PEAP_AUTHENTICATOR_METHOD_ROUTINES;

Miembros

dwSizeInBytes

Versión de estructura definida por el implementador.

Nota Microsoft no define los valores de este campo.
 

pEapType

Puntero a una estructura de EAP_METHOD_TYPE que contiene la información del proveedor sobre el implementador de las API a las que apuntan los miembros de esta estructura.

EapMethodAuthenticatorInitialize

Puntero de función a EapMethodAuthenticatorInitialize.

pEapType

EAP_METHOD_TYPE valor de enumeración que especifica el tipo de autenticación de EAP que se usará para esta sesión.

ppEapError

Puntero a la dirección de una estructura de EAP_ERROR que contiene los errores generados por EAPHost durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse pasando un puntero a los datos de error a EapPeerFreeErrorMemory.

EapMethodAuthenticatorBeginSession

Puntero de función a EapMethodAuthenticatorBeginSession.

dwFlags

Combinación de marcas EAP que describen el comportamiento de la sesión de autenticación de EAP.

pwszIdentity

Cadena Unicode terminada en cero que contiene la identidad del usuario que se va a autenticar.

pAttributeArray

Puntero a una estructura de matriz EapAttributes que especifica los atributos EAP de la entidad que se van a autenticar.

dwSizeOfConnectionData

Especifica el tamaño, en bytes, del búfer de datos de conexión proporcionado en pConnectionData.

pConnectionData

Puntero a un búfer de bytes que contiene el BLOB de datos de configuración opaco.

dwMaxSendPacketSize

Especifica el tamaño máximo, en bytes, de un paquete EAP enviado durante la sesión.

pSessionHandle

Recibe un puntero a una estructura de EAP_SESSION_HANDLE que contiene el identificador único de la nueva sesión de autenticación de EAP en el servidor EAPHost.

ppEapError

Puntero a la dirección de una estructura de EAP_ERROR que contiene los errores generados por EAPHost durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse pasando un puntero a los datos de error a EapPeerFreeErrorMemory.

EapMethodAuthenticatorUpdateInnerMethodParams

Puntero de función a EapMethodAuthenticatorUpdateInnerMethodParams.

sessionHandle

EAP_SESSION_HANDLE valor que contiene el identificador específico de la sesión de autenticación de EAP en el servidor EAPHost. Este identificador se obtiene mediante una llamada anterior a EapMethodAuthenticatorBeginSession.

dwFlags

Combinación de marcas EAP que describen el comportamiento de la sesión de autenticación de EAP.

pwszIdentity

Cadena Unicode terminada en cero que contiene la identidad actualizada del usuario que se va a autenticar.

pAttributeArray

Puntero a una estructura de matriz EapAttributes que especifica los atributos EAP actualizados de la entidad que se van a autenticar.

ppEapError

Puntero a la dirección de una estructura de EAP_ERROR que contiene los errores generados durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse pasando un puntero a los datos de error a EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorReceivePacket

Puntero de función a EapMethodAuthenticatorReceivePacket.

sessionHandle

EAP_SESSION_HANDLE valor que contiene el identificador específico de la sesión de autenticación de EAP en el servidor EAPHost. Este identificador se obtiene mediante una llamada anterior a EapMethodAuthenticatorBeginSession.

cbReceivePacket

Tamaño, en bytes, de pReceivePacket.

pReceivePacket

Puntero a una estructura EapPacket que contiene un paquete de sesión de autenticación EAP recibido del suplicante por el servidor EAPHost.

pEapOutput

Recibe un puntero a un valor de enumeración EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION que indica la siguiente acción que el suplicante debe realizar en la sesión de autenticación de EAP.

ppEapError

Puntero a la dirección de una estructura de EAP_ERROR que contiene los errores generados por EAPHost durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse pasando un puntero a los datos de error a EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorSendPacket

Puntero de función a EapMethodAuthenticatorSendPacket.

sessionHandle

EAP_SESSION_HANDLE valor que contiene el identificador específico de la sesión de autenticación de EAP en el servidor EAPHost. Este identificador se obtiene mediante una llamada anterior a EapMethodAuthenticatorBeginSession.

bPacketId

Especifica un valor de identificador numérico para el paquete que se va a enviar.

pcbSendPacket

Especifica el tamaño máximo, en bytes, del paquete que se va a enviar. A la devolución, este parámetro recibe el tamaño, en bytes, del paquete devuelto en pEapPacket.

pSendPacket

Recibe un puntero a una estructura EapPacket que contiene el paquete que se va a enviar al suplicante.

pTimeout

Recibe un puntero a un valor de EAP_AUTHENTICATOR_SEND_TIMEOUT que especifica el tiempo de espera del paquete.

ppEapError

Puntero a la dirección de una estructura de EAP_ERROR que contiene los errores generados durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse pasando un puntero a los datos de error a EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorGetAttributes

Puntero de función a EapMethodAuthenticatorGetAttributes.

sessionHandle

EAP_SESSION_HANDLE valor que contiene el identificador específico de la sesión de autenticación de EAP en el servidor EAPHost. Este identificador se obtiene mediante una llamada anterior a EapMethodAuthenticatorBeginSession.

pAttribs

Recibe un puntero a una estructura EapAttributes que contiene una matriz de atributos de respuesta de autenticación de EAP para el supplicante.

ppEapError

Puntero a la dirección de una estructura de EAP_ERROR que contiene los errores generados durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse pasando un puntero a los datos de error a EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorSetAttributes

Puntero de función a EapMethodAuthenticatorSetAttributes.

sessionHandle

EAP_SESSION_HANDLE valor que contiene el identificador específico de la sesión de autenticación de EAP en el servidor EAPHost. Este identificador se obtiene mediante una llamada anterior a EapMethodAuthenticatorBeginSession.

pAttribs

Puntero a una estructura EapAttributes que contiene una matriz de nuevos atributos de respuesta de autenticación de EAP que se van a establecer para el supplicante en EAPHost.

pEapOutput

Recibe un puntero a un valor de enumeración EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION que especifica la acción sugerida que el suplicante debe realizar como respuesta a los atributos actualizados.

ppEapError

Puntero a la dirección de una estructura de EAP_ERROR que contiene los errores generados durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse pasando un puntero a los datos de error a EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorGetResult

Puntero de función a EapMethodAuthenticatorGetResult.

sessionHandle

EAP_SESSION_HANDLE valor que contiene el identificador específico de la sesión de autenticación de EAP en el servidor EAPHost. Este identificador se obtiene mediante una llamada anterior a EapMethodAuthenticatorBeginSession.

pResult

Recibe un puntero a una estructura de EAP_METHOD_AUTHENTICATOR_RESULT que contiene los resultados de autenticación.

ppEapError

Puntero a la dirección de una estructura de EAP_ERROR que contiene los errores generados por EAPHost durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse pasando un puntero a los datos de error a EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorEndSession

Puntero de función a EapMethodAuthenticatorEndSession.

sessionHandle

EAP_SESSION_HANDLE valor que contiene el identificador específico de la sesión de autenticación de EAP que se cerrará en el servidor EAPHost. Este identificador se obtiene mediante una llamada anterior a EapMethodAuthenticatorBeginSession.

ppEapError

Puntero a la dirección de una estructura de EAP_ERROR que contiene los errores generados por EAPHost durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse pasando un puntero a los datos de error a EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorShutdown

Puntero de función a EapMethodAuthenticatorShutdown.

pEapType

Valor de enumeración EAP_METHOD_TYPE que especifica el tipo de autenticación EAP usada en la sesión.

ppEapError

Puntero a la dirección de una estructura de EAP_ERROR que contiene los errores generados durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse pasando un puntero a los datos de error a EapMethodAuthenticatorFreeErrorMemory.

Comentarios

Cada DLL de método autenticador de EAP debe tener implementaciones públicas de las siguientes API en ella.

Estas API se llaman en un método de autenticación EAP cuando un EAPHost (autenticador) (servidor) recibe una llamada de procedimiento remoto correspondiente específica desde un método EAP del mismo nivel (cliente). Tenga en cuenta que una correspondencia completa uno a uno no existe entre los métodos del mismo nivel EAP y los métodos autenticadores de EAP; Las llamadas API del método autenticador de EAP específicas se deben realizar en función de los requisitos de la implementación de las llamadas API del método autenticador de EAP.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado eapmethodauthenticatorapis.h

Consulte también

Estructuras del método EAPHost Authenticator

EapMethodAuthenticatorGetInfo