EapPeerInvokeIdentityUI 函数 (eapmethodpeerapis.h)

引发自定义交互式用户界面对话框，以获取客户端上 EAP 方法的用户标识信息。

语法

DWORD EapPeerInvokeIdentityUI(
  [in]  EAP_METHOD_TYPE *pEapType,
  [in]  DWORD           dwFlags,
  [in]  HWND            hwndParent,
  [in]  DWORD           dwSizeOfConnectionData,
  [in]  const BYTE      *pConnectionData,
  [out] DWORD           dwSizeOfUserData,
  [in]  const BYTE      *pUserData,
  [out] DWORD           *pdwSizeOfUserDataOut,
  [out] BYTE            **ppUserDataOut,
  [out] LPWSTR          *ppwszIdentity,
  [out] EAP_ERROR       **ppEapError
);

参数

[in] pEapType

一个 EAP_METHOD_TYPE 结构，其中包含有关用于对连接进行身份验证的 EAP 方法的供应商和作者信息。

[in] dwFlags

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

[in] hwndParent

父窗口的句柄，它将生成交互式用户界面对话框以获取标识数据。

[in] dwSizeOfConnectionData

pUIContextData 指定的用户界面上下文数据的大小（以字节为单位）。

[in] pConnectionData

指向包含连接数据的不透明字节缓冲区的指针。

[out] dwSizeOfUserData

指定 dwSizeOfUserData 中返回的用户标识数据的大小（以字节为单位）。

[in] pUserData

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

[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

请参阅

EAPHost 对等方法配置函数

EapPeerInvokeIdentityUI