RasEapInvokeConfigUI 函数 (raseapif.h)

项目
08/25/2023

RAS 连接管理器调用 RasEapInvokeConfigUI 函数以显示一个对话框，用于从用户获取配置信息。如果条目的身份验证协议提供配置用户界面，则创建新的电话簿条目或编辑现有电话簿条目时，RAS 调用 RasEapInvokeConfigUI 。

语法

DWORD RasEapInvokeConfigUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  DWORD dwFlags,
  [in]  BYTE  *pConnectionDataIn,
  [in]  DWORD dwSizeOfConnectionDataIn,
  [out] BYTE  **ppConnectionDataOut,
  [out] DWORD *pdwSizeOfConnectionDataOut
);

parameters

[in] dwEapTypeId

指定要为其调用配置 UI 的身份验证协议。

[in] hwndParent

UI 对话框的父窗口的句柄。

[in] dwFlags

指定限定身份验证过程的以下标志的零个或多个。

标志	含义
RAS_EAP_FLAG_ROUTER	指定拨入的计算机是路由器。缺少此标志表示拨入的计算机是 RAS 客户端。
RAS_EAP_FLAG_8021X_AUTH	指定此会话在无线上下文中执行。
RAS_EAP_FLAG_GUEST_ACCESS	如果客户端需要来宾访问，则指定。此标志通常用于无线连接的情况，这样，如果连续 N 次的身份验证失败，则尝试无线客户端（如果配置为请求来宾访问），然后通过传递此标志来执行此操作。 RADIUS 服务器应设置为允许来宾访问。

[in] pConnectionDataIn

指向当前存储在电话簿条目中的连接数据的指针。如果电话簿条目不包含任何数据，则此参数为 NULL。

[in] dwSizeOfConnectionDataIn

指定当前存储在电话簿条目中的连接数据的大小。如果此连接的电话簿条目不包含任何数据，则此参数为零。

[out] ppConnectionDataOut

指向成功返回时指向要存储在电话簿条目中的新连接数据的指针的指针。这些数据都不应特定于当前计算机;电话簿条目应可在计算机之间移植。

[out] pdwSizeOfConnectionDataOut

指向 DWORD 的指针，该 DWORD 接收要存储在电话簿条目中的新连接数据的大小。

返回值

如果函数成功，则返回值 NO_ERROR。

如果函数无法为配置数据分配内存，则应 ERROR_NOT_ENOUGH_MEMORY返回值。

如果函数以其他方式失败，则返回值应为 Winerror.h、Raserror.h 或 Mprerror.h 中的相应错误代码。

注解

实现 RasEapInvokeConfigUI 和 RasEapFreeMemory 的 DLL 可能支持多个身份验证协议。 dwEapTypeId 参数指定要调用配置 UI 的协议。

RAS 将 RasEapInvokeConfigUI 返回的连接数据存储在客户端计算机上连接的电话簿条目中。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	raseapif.h