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 方法上实现，并且必须严格遵循文档中指定的语法和参数类型。
要求
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | eapmethodpeerapis.h |