Client-Side配置用户界面
实现身份验证协议的供应商还可以为协议提供配置用户界面 (UI) 。 配置 UI 可以在与身份验证协议相同的 DLL 中实现,也可以在单独的 DLL 中实现。 此外,实现配置 UI 的 DLL 可能支持多个身份验证协议。 配置 UI 的 DLL 路径存储在RAS_EAP_VALUENAME_CONFIGUI注册表值中,位于身份验证协议的 项下。 有关创建此注册表值的详细信息,请参阅 EAP 安装。
配置用户界面的 DLL 应导出以下函数的入口点:
当用户为特定连接(无论是 RAS 还是无线客户端)创建配置项时,用户都可以选择服务应使用该条目的身份验证协议。 如果身份验证协议可配置,则服务会调用 RasEapInvokeConfigUI 来调用配置 UI。 配置 UI 将 RasEapInvokeConfigUI 返回的配置信息存储在配置条目中。
配置信息应是客户端计算机上所有用户的通用信息。 特定于特定用户的信息不应存储在条目中。 身份验证协议应使用 标识函数 或 交互式用户界面获取特定于用户的信息。 身份验证协议可以将此信息存储在注册表中,方法是将其传递给 RasEapMakeMessage 的 pEapOutput 参数中的身份验证服务。
配置信息不应特定于当前计算机;它应可移植到计算机。
当身份验证服务为身份验证协议调用 RasEapBegin 函数时,它会传递包含指向配置信息的指针 的PPP_EAP_INPUT 结构。 对 RasEapBegin 的调用完成后,身份验证服务会调用 RasEapFreeMemory 以释放配置信息占用的内存。 因此,在调用 RasEapBegin 期间,身份验证协议应将配置信息复制到专用内存缓冲区中。
供应商可以在身份验证协议的注册表项下添加一个值,该值指定协议的默认配置信息。 供应商还可以添加一个值,该值指定用户在创建电话簿条目时是否需要输入配置信息。 有关详细信息,请参阅 身份验证协议注册表值。