Función EapPeerBeginSession (eapmethodpeerapis.h)
Inicia una sesión de autenticación de EAP en el EAPHost del mismo nivel mediante el método EAP.
Sintaxis
DWORD EapPeerBeginSession(
[in] DWORD dwFlags,
[in] const EapAttributes * const pAttributeArray,
[in] HANDLE hTokenImpersonateUser,
[in] DWORD dwSizeofConnectionData,
[in] BYTE *pConnectionData,
[in] DWORD dwSizeofUserData,
[in] BYTE *pUserData,
[in] DWORD dwMaxSendPacketSize,
[out] EAP_SESSION_HANDLE *pSessionHandle,
[out] EAP_ERROR **ppEapError
);
Parámetros
[in] dwFlags
Combinación de marcas EAP que describen el nuevo comportamiento de la sesión de autenticación de EAP.
[in] pAttributeArray
Puntero a una estructura de matriz EAP_ATTRIBUTES que especifica los atributos EAP de la entidad que se van a autenticar.
[in] hTokenImpersonateUser
Especifica un identificador para el token de suplantación de usuario que se va a usar en esta sesión.
[in] dwSizeofConnectionData
Especifica el tamaño, en bytes, del búfer de datos de conexión proporcionado en pConnectionData.
[in] pConnectionData
Datos de conexión específicos de este método que se usan para decidir los datos de usuario devueltos desde esta API, donde los datos del usuario dependen de cierta configuración de datos de conexión. Cuando este parámetro es NULL , la implementación del método debe usar valores predeterminados para la conexión.
[in] dwSizeofUserData
Especifica el tamaño en bytes del búfer de datos de usuario proporcionado en pUserData.
[in] pUserData
Puntero a un búfer de bytes que contiene el BLOB de datos de usuario opaco.
[in] dwMaxSendPacketSize
Especifica el tamaño máximo en bytes de un paquete EAP enviado durante la sesión. Si el método necesita enviar un paquete mayor que el tamaño máximo, el método debe dar cabida a la fragmentación y el reensamblaje.
[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
Puntero a un puntero a 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 llamando a EapPeerFreeErrorMemory.
Valor devuelto
None
Observaciones
Esta llamada la realiza un EAPHost basado en el mismo nivel mediante un puntero de función a esta API. Esta API debe implementarse en el método EAP cargado por EAPHost y debe cumplir estrictamente la sintaxis y los tipos de parámetro especificados en la documentación.
Requisitos
| 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 | eapmethodpeerapis.h |