Función EapMethodAuthenticatorBeginSession (eapmethodauthenticatorapis.h)
Crea una nueva sesión de autenticación de EAP en el servidor EAPHost.
EapMethodAuthenticatorBeginSession es un prototipo de función.
Sintaxis
DWORD EapMethodAuthenticatorBeginSession(
[in] DWORD dwFlags,
[in] BYTE bInitialId,
LPCWSTR pwszIdentity,
[in] const EapAttributes * const pAttributeArray,
[in] DWORD dwSizeofConnectionData,
const BYTE * const pConnectionData,
[in] DWORD dwMaxSendPacketSize,
[out] EAP_SESSION_HANDLE *pSessionHandle,
[out] EAP_ERROR **ppEapError
);
Parámetros
[in] dwFlags
Combinación de marcas EAP que describen el comportamiento de la sesión de autenticación de EAP.
[in] bInitialId
Cadena Unicode terminada en cero que contiene la identidad del usuario que se va a autenticar.
pwszIdentity
Identidad del usuario que se autentica.
[in] pAttributeArray
Puntero a una estructura de matriz EapAttributes que especifica los atributos EAP de la entidad que se van a autenticar.
[in] dwSizeofConnectionData
Especifica el tamaño en bytes de los datos a los que apunta pConnectionData. Si pConnectionData es NULL, este miembro es cero.
pConnectionData
Puntero a los datos de conexión recibidos de la interfaz de usuario de configuración del protocolo de autenticación.
[in] dwMaxSendPacketSize
Especifica el tamaño máximo, en bytes, de un paquete EAP enviado durante la sesión.
[out] pSessionHandle
Puntero a una estructura de EAP_SESSION_HANDLE que contiene el identificador único para esta sesión de autenticación de EAP en el servidor EAPHost.
[out] ppEapError
Opcionalmente, recibe un puntero a un puntero a 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 EapMethodAuthenticatorFreeMemory.
Valor devuelto
None
Observaciones
Esta llamada se realiza mediante un EAPHost basado en autenticador mediante un puntero de función a esta API. Esta API debe implementarse en el método autenticador EAP cargado por EAPHost y debe cumplir estrictamente la sintaxis y los tipos de parámetro especificados en la documentación.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | eapmethodauthenticatorapis.h |