EapPeerBeginSession 函数 (eapmethodpeerapis.h)
使用 EAP 方法在对等 EAPHost 上启动 EAP 身份验证会话。
语法
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
);
参数
[in] dwFlags
描述新 EAP 身份验证会话行为的 EAP 标志 的组合。
[in] pAttributeArray
指向 EAP_ATTRIBUTES 数组结构的指针，该结构指定要进行身份验证的实体的 EAP 属性。
[in] hTokenImpersonateUser
指定要在此会话中使用的用户模拟令牌的句柄。
[in] dwSizeofConnectionData
指定 pConnectionData 中提供的连接数据缓冲区的大小（以字节为单位）。
[in] pConnectionData
特定于此方法的连接数据，用于确定从此 API 返回的用户数据，其中用户数据依赖于特定的连接数据配置。 当此参数为 NULL 时，方法实现应使用默认值进行连接。
[in] dwSizeofUserData
指定 pUserData 中提供的用户数据缓冲区的大小（以字节为单位）。
[in] pUserData
指向包含不透明用户数据 BLOB 的字节缓冲区的指针。
[in] dwMaxSendPacketSize
指定会话期间发送的 EAP 数据包的最大大小（以字节为单位）。 如果方法需要发送大于最大大小的数据包，该方法必须适应碎片和重新组合。
[out] pSessionHandle
指向 EAP_SESSION_HANDLE 结构的指针，该结构包含 EAPHost 服务器上此 EAP 身份验证会话的唯一句柄。
[out] ppEapError
指向 EAP_ERROR 结构的指针的指针，该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过调用 EapPeerFreeErrorMemory 来释放此内存。
返回值
无
备注
此调用由基于对等的 EAPHost 使用指向此 API 的函数指针执行。 此 API 必须在 EAPHost 加载的 EAP 方法上实现，并且必须严格遵循文档中指定的语法和参数类型。
要求
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | eapmethodpeerapis.h |