EapHostPeerInvokeIdentityUI 函数 (eaphostpeerconfigapis.h)

此函数由隧道方法调用，以调用内部方法的标识 UI。 此函数返回用于启动身份验证的标识和凭据。

语法

DWORD EapHostPeerInvokeIdentityUI(
  [in]      DWORD           dwVersion,
  [in]      EAP_METHOD_TYPE eapMethodType,
  [in]      DWORD           dwFlags,
  [in]      HWND            hwndParent,
  [in]      DWORD           dwSizeofConnectionData,
  [in]      const BYTE      *pConnectionData,
  [in]      DWORD           dwSizeofUserData,
  [in]      const BYTE      *pUserData,
  [in, out] DWORD           *pdwSizeOfUserDataOut,
  [out]     BYTE            **ppUserDataOut,
  [out]     LPWSTR          *ppwszIdentity,
  [out]     EAP_ERROR       **ppEapError,
  [in, out] LPVOID          *ppvReserved
);

参数

[in] dwVersion

API 的版本号。 必须设置为零。

[in] eapMethodType

一个EAP_METHOD_TYPE结构，指定要用于此会话的 EAP 身份验证类型。

[in] dwFlags

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

[in] hwndParent

将在其中显示配置对话框的父窗口的句柄。

[in] dwSizeofConnectionData

由 pConnectionData 参数指示的缓冲区的大小（以字节为单位）。

[in] pConnectionData

指向用于 EAP 方法的配置数据的指针。

[in] dwSizeofUserData

pUserData 参数指示的缓冲区的大小（以字节为单位）。

[in] pUserData

指向与此身份验证相关的用户凭据信息的指针。

[in, out] pdwSizeOfUserDataOut

用于接收 ppUserDataOut 参数返回的用户数据的缓冲区集的大小（以字节为单位）。

[out] ppUserDataOut

指向缓冲区的指针的指针，该缓冲区包含方法返回的用户数据信息。 使用后，必须通过调用 EapHostPeerFreeMemory 来释放此内存。

[out] ppwszIdentity

指向以 NULL 结尾的用户标识字符串的指针。 使用后，必须通过调用 EapHostPeerFreeMemory 来释放此内存。

[out] ppEapError

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

[in, out] ppvReserved

保留供将来使用。

返回值

无

要求

另请参阅

EAPHost 请求配置函数