通过

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

请参阅

EAPHost 对等方法 Run-Time 函数

EapPeerEndSession

SSO 和 PLAP