EapPeerSetCredentials 函数 (eapmethodpeerapis.h)
向 EAP 方法提供新的或更新的身份验证凭据。
语法
DWORD EapPeerSetCredentials(
[in] EAP_SESSION_HANDLE sessionHandle,
[in] LPWSTR pwszIdentity,
[in] LPWSTR pwszPassword,
[out] EAP_ERROR **ppEapError
);
参数
[in] sessionHandle
指向 EAP_SESSION_HANDLE 结构的指针,该结构包含 EAPHost 服务器上此 EAP 身份验证会话的唯一句柄。 在以前调用 EapPeerBeginSession 时,此句柄在 pSessionHandle 参数中返回。
[in] pwszIdentity
一个指针,指定要为其设置凭据的用户标识。 此用户标识字符串是通过调用 EapPeerGetIdentity 函数获取的。
[in] pwszPassword
包含用户标识的明文密码的指针。
[out] ppEapError
指向 EAP_ERROR 结构的指针的指针,该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后,必须通过调用 EapPeerFreeErrorMemory 来释放此内存。
返回值
无
备注
如果设置了注册表项 InvokeUserNameDlg ,则应导出 EapPeerSetCredentials 。 如果未设置注册表项 InvokeUserNameDlg , EapPeerSetCredentials 应导出 EapPeerGetIdentity 和 EapPeerInvokeIdentityUI 函数。
此调用由基于对等的 EAPHost 使用指向此 API 的函数指针执行。 此 API 必须在 EAPHost 加载的 EAP 方法上实现,并且必须严格遵循文档中指定的语法和参数类型。
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | eapmethodpeerapis.h |