EapPeerGetIdentity 函数 (eapmethodpeerapis.h)

在 EAPHost 调用后返回用户数据和用户标识。

语法

DWORD EapPeerGetIdentity(
  [in]      DWORD      dwFlags,
  [in]      DWORD      dwSizeofConnectionData,
  [in]      const BYTE *pConnectionData,
  [in]      DWORD      dwSizeofUserData,
  [in]      const BYTE *pUserData,
  [in]      HANDLE     hTokenImpersonateUser,
  [out]     BOOL       *pfInvokeUI,
  [in, out] DWORD      *pdwSizeOfUserDataOut,
  [out]     BYTE       **ppUserDataOut,
  [out]     LPWSTR     *ppwszIdentity,
  [out]     EAP_ERROR  **ppEapError
);

参数

[in] dwFlags

描述 EAP 身份验证会话行为的 EAP 标志的组合。

[in] dwSizeofConnectionData

指定 pConnectionData 中提供的连接数据缓冲区的大小（以字节为单位）

[in] pConnectionData

指向包含不透明配置数据 BLOB 的字节缓冲区的指针。

[in] dwSizeofUserData

指定 pUserData 中提供的用户数据缓冲区的大小（以字节为单位）。

[in] pUserData

指向特定于此身份验证的用户数据的指针，用于预填充用户数据。 首次调用此 API 或启动新的身份验证会话时，此参数为 NULL。 否则，请将此参数设置为 EapPeerGetResult 接收的 ppResult 参数指向的结构的 pUserData 成员。

[in] hTokenImpersonateUser

指定要进行身份验证的用户的模拟令牌的句柄。 执行计算机身份验证时，此句柄将为 NULL 。 通过使用此句柄，EAP 方法可以模拟用户，以获取用户特定的信息，例如用户名、域名和凭据。

[out] pfInvokeUI

如果未成功返回用户标识和用户数据 Blob，则返回 TRUE ，并且 该方法寻求通过用户界面对话框从用户那里收集信息。

[in, out] pdwSizeOfUserDataOut

指定 ppUserDataOut 缓冲区的大小（以字节为单位）。

[out] ppUserDataOut

指向返回的用户数据的指针的指针。 数据作为输入 pUserData 传递到 EapPeerBeginSession。

[out] ppwszIdentity

指向返回的用户标识的指针。 指针将包含在标识响应数据包中，并返回到服务器。

[out] ppEapError

指向 指向EAP_ERROR 结构的指针的指针，该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过调用 EapPeerFreeErrorMemory 来释放此内存。

返回值

无

备注

此调用由基于对等的 EAPHost 使用指向此 API 的函数指针执行。 此 API 必须在 EAPHost 加载的 EAP 方法上实现，并且必须严格遵循文档中指定的语法和参数类型。

要求

请参阅

EAPHost 对等方法 Run-Time 函数

EapPeerInvokeIdentityUI