EapHostPeerGetIdentity 函数 (eappapis.h)

此函数由隧道方法调用，以从内部方法请求标识信息。 此函数返回标识和用户凭据信息。

语法

DWORD EapHostPeerGetIdentity(
  [in]      DWORD           dwVersion,
  [in]      DWORD           dwFlags,
  [in]      EAP_METHOD_TYPE eapMethodType,
  [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, out] BYTE            **ppvReserved
);

参数

[in] dwVersion

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

[in] dwFlags

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

[in] eapMethodType

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

[in] dwSizeofConnectionData

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

[in] pConnectionData

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

[in] dwSizeofUserData

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

[in] pUserData

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

[in] hTokenImpersonateUser

登录用户的模拟令牌，用于收集用户相关信息。

[out] pfInvokeUI

如果用户标识和用户数据 Blob 未成功返回，并且方法通过用户界面对话框寻求从用户收集信息，则返回 TRUE 。

[in, out] pdwSizeOfUserDataOut

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

[out] ppUserDataOut

方法返回的用户数据信息。 使用后，必须通过调用 EapHostPeerFreeRuntimeMemory 来释放此内存。

[out] ppwszIdentity

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

[out] ppEapError

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

[in, out] ppvReserved

保留以供将来使用

返回值

无

要求

请参阅

EAPHost Supplicant Run-Time Functions

EapHostPeerGetUIContext