EapMethodAuthenticatorInvokeConfigUI 函数 (eapmethodauthenticatorapis.h)
定义一个函数,该函数在客户端上引发 EAP 方法的连接配置用户界面对话框。
EapMethodAuthenticatorInvokeConfigUI 是一个函数原型。
必须在为单线程单元初始化 COM 的线程上调用 EapHostAuthenticatorInvokeConfigUI。 这可以通过调用 COM API CoInitialize 来实现;如果请求者已完成 STA 线程 CoUninitialize ,则必须在退出之前调用 。
语法
DWORD EapMethodAuthenticatorInvokeConfigUI(
[in] EAP_METHOD_TYPE *pEapMethodType,
[in] HWND hwndParent,
[in] DWORD dwFlags,
[in] LPCWSTR pwszMachineName,
[in] DWORD dwSizeOfConfigIn,
[in] BYTE *pConfigIn,
[out] DWORD *pdwSizeOfConfigOut,
[out] BYTE **ppConfigOut,
[out] EAP_ERROR **ppEapError
);
参数
[in] pEapMethodType
指向 EAP_METHOD_TYPE 结构的指针,该结构包含有关用于对连接进行身份验证的 EAP 方法的供应商和作者信息。
[in] hwndParent
将启动连接配置用户界面对话框的父窗口的句柄。
[in] dwFlags
描述 EAP 身份验证会话行为的 EAP 标志的组合。
[in] pwszMachineName
正在配置的目标计算机的名称。 NULL 表示正在配置本地计算机。
[in] dwSizeOfConfigIn
指定 pConfigIn 的大小(以字节为单位)。 可以设置为 0。
[in] pConfigIn
指向包含配置元素的字节缓冲区的指针。 缓冲区的大小为 dwSizeOfConfigIn。 如果将 dwSizeOfConfigIn 设置为 0,此参数可以为 NULL。
[out] pdwSizeOfConfigOut
指定 ppConfigOut 中返回的配置数据的大小(以字节为单位)。
[out] ppConfigOut
指向包含用户已更新配置数据的字节缓冲区的指针的指针。 使用数据后,必须通过调用 EapMethodAuthenticatorFreeMemory 来释放此内存。
[out] ppEapError
指向 EAP_ERROR 结构的地址的指针,该结构包含 EAPHost 在执行此函数调用期间引发的任何错误。 使用错误数据后,必须通过调用 EapMethodAuthenticatorFreeErrorMemory 来释放此内存。
返回值
无
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | eapmethodauthenticatorapis.h |