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
保留以供将来使用
返回值
无
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | eappapis.h |
Library | Eappprxy.lib |
DLL | Eapphost.dll |