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 。 如果未设置注册表项 InvokeUserNameDlgEapPeerSetCredentials 应导出 EapPeerGetIdentityEapPeerInvokeIdentityUI 函数。

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

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 eapmethodpeerapis.h

请参阅

EAPHost 对等方法 Run-Time 函数

EapPeerGetIdentity

EapPeerInvokeIdentityUI

EapPeerSetCredentials