EapPeerQueryUIBlobFromInteractiveUIInputFields 函数 (eapmethodpeerapis.h)
EapPeerQueryUIBlobFromInteractiveUIInputFields 函数将用户信息转换为可供 EAPHost 运行时函数使用的用户 BLOB。
语法
DWORD EapPeerQueryUIBlobFromInteractiveUIInputFields(
[in] DWORD dwVersion,
[in] DWORD dwFlags,
[in] DWORD dwSizeofUIContextData,
[in] const BYTE *pUIContextData,
[in] const EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
[out] DWORD *pdwSizeOfDataFromInteractiveUI,
[out] BYTE **ppDataFromInteractiveUI,
[out] EAP_ERROR **ppEapError,
[in, out] LPVOID *ppvReserved
);
参数
[in] dwVersion
API 的版本号。 必须设置为零。
[in] dwFlags
描述 EAP 身份验证会话行为的 EAP 标志的组合。
[in] dwSizeofUIContextData
pUIContextData 参数中上下文数据的大小(以字节为单位)。
[in] pUIContextData
指向包含 UI 上下文数据的 BLOB 的指针,表示为指向字段数据的内部指针。 请求者从 EAPHost 运行时函数获取这些内部指针。
[in] pEapInteractiveUIData
用于接收 EAP_INTERACTIVE_UI_DATA 结构的指针,该结构包含 EAP 请求方上引发的交互式用户界面组件的配置信息。
[out] pdwSizeOfDataFromInteractiveUI
指向 DWORD 的指针,该指针指定 ppDataFromInteractiveUI 参数指向的缓冲区的大小(以字节为单位)。 如果未将此值设置为 0,则必须在 ppDataFromInteractiveUI 参数中提供指向此参数中指定的大小的缓冲区的指针。
[out] ppDataFromInteractiveUI
一个指针,用于接收可用于身份验证的凭据 BLOB。 调用方应使用 EapPeerFreeMemory 函数释放内部指针,从最内部的指针开始。 如果为此参数提供了非 NULL 值,这意味着将现有数据 BLOB 传递给该参数,则所提供的数据 BLOB 将更新并在此参数中返回。
[out] ppEapError
指向 EAP_ERROR 结构的地址的指针,该结构包含 EAPHost 在执行此函数调用期间引发的任何错误。 使用错误数据后,必须通过调用 EapPeerFreeErrorMemory 来释放此内存。
[in, out] ppvReserved
保留供将来使用。 此参数必须设置为 0。
返回值
无
备注
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | eapmethodpeerapis.h |