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

请参阅

EAPHost Authenticator 方法函数