EapMethodAuthenticatorBeginSession 函数 (eapmethodauthenticatorapis.h)
在服务器 EAPHost 上创建新的 EAP 身份验证会话。
EapMethodAuthenticatorBeginSession 是一个函数原型。
语法
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
);
参数
[in] dwFlags
描述 EAP 身份验证会话行为的 EAP 标志的组合。
[in] bInitialId
包含要进行身份验证的用户标识的零终止 Unicode 字符串。
pwszIdentity
正在进行身份验证的用户的标识。
[in] pAttributeArray
指向 EapAttributes 数组结构的指针，该结构指定要进行身份验证的实体的 EAP 属性。
[in] dwSizeofConnectionData
指定 pConnectionData 指向的数据的大小（以字节为单位）。 如果 pConnectionData 为 NULL，则此成员为零。
pConnectionData
指向从身份验证协议的配置用户界面接收的连接数据的指针。
[in] dwMaxSendPacketSize
指定会话期间发送的 EAP 数据包的最大大小（以字节为单位）。
[out] pSessionHandle
指向 EAP_SESSION_HANDLE 结构的指针，该结构包含 EAPHost 服务器上此 EAP 身份验证会话的唯一句柄。
[out] ppEapError
（可选）接收指向 指向EAP_ERROR 结构的指针的指针，该结构包含 EAPHost 在执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过将指向错误数据的指针传递到 EapMethodAuthenticatorFreeMemory 来释放此内存。
返回值
无
备注
此调用由基于验证器的 EAPHost 使用指向此 API 的函数指针来执行。 此 API 必须在 EAPHost 加载的 EAP 验证器方法上实现，并且必须严格遵循文档中指定的语法和参数类型。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | eapmethodauthenticatorapis.h |