在网络连接向导中显示自定义 UI 页

  • 项目

 

通过以下任一方式发出 UI 请求时，可以在操作系统的网络连接向导中显示本机 802.11 IHV UI 扩展 DLL 支持的自定义用户界面 () UI：

如果无线 LAN (WLAN) 适配器尝试连接到无线网络，操作系统会在网络连接向导中显示自定义 UI。 在这种情况下，对自定义 UI 的请求将在时间段内显示为气球通知：

在网络连接向导中插入自定义 UI 请求时，操作系统将执行以下操作：

  1. 调用 Native 802.11 IHV 扩展 DLL 的 Dot11ExtIhvIsUIRequestPending IHV 处理程序函数，以确定 UI 请求是否仍处于挂起状态。 操作系统使用由 Native 802.11 IHV Extensions DLL 传递给 Dot11ExtSendUIRequest 的全局唯一标识符 (GUID) 指定 UI 请求。

  2. 如果 Dot11ExtIhvIsUIRequestPending 为指定的 UI 请求返回 TRUE ，操作系统将实例化请求的 IWizardExtension COM 接口，并将其绑定到网络连接向导的当前 UI 流中。 在调用 Dot11ExtSendUIRequest 时，Native 802.11 IHV 扩展 DLL 指定本机 802.11 IHV UI 扩展 DLL 中 IWizardExtension 实现的类标识符 (CLSID) 。

    操作系统还调用 IWizardExtension：：AddPages 方法，Native 802.11 IHV UI Extensions DLL 通过该方法返回表示自定义 UI 页面的 PROPSHEETPAGE 结构的句柄数组。

    有关 IWizardExtension COM 接口的详细信息，请参阅 IWizardExtension COM 接口。

  3. 通过 IWizardSite COM 接口在本机 802.11 IHV UI 扩展 DLL 控制的 UI 页面中导航。 有关此接口的详细信息，请参阅 IWizardSite COM 接口。

显示自定义 UI 时，Native 802.11 IHV UI Extensions DLL 可以通过 IPropertyBag COM 接口读取或写入特定于上下文的数据。 有关此过程的详细信息，请参阅 访问配置文件和上下文数据。

显示自定义 UI 后，Native 802.11 IHV UI 扩展 DLL 可以通过调用 WlanSendUIResponse 将用户输入的响应数据返回到 Native 802.11 IHV 扩展 DLL。 DLL 传入 UI 请求的 GUID，以及指向包含响应数据的缓冲区的指针。

在 Native 802.11 IHV UI Extensions DLL 调用 WlanSendUIResponse 之后，操作系统调用 Native 802.11 IHV 扩展 DLL 的 Dot11ExtIhvProcessUIResponse IHV 处理程序函数来转发自定义 UI 的响应数据。

有关 WlanSendUIResponse API 的详细信息，请参阅Microsoft Windows SDK中的文档。