在气球通知中显示自定义 UI 页

  • 项目

 

如果 Native 802.11 IHV 扩展 DLL 调用 Dot11ExtSendUIRequest 来显示自定义用户界面 (UI) ，如果无线 LAN (WLAN) 适配器已连接到无线网络，则操作系统将通过可单击的气球通知显示 UI。 在这种情况下，对自定义 UI 的请求显示为气球通知：

有关 Native 802.11 IHV 扩展 DLL 如何请求显示自定义 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 ，则操作系统将调用 Native 802.11 IHV UI 扩展 DLL 的 IDot11ExtUI：：GetDot11ExtUIBalloonText 方法。 通过此方法，DLL 返回一个字符串缓冲区，其中包含要显示在气球通知中的本地化文本。

  3. 显示包含本地化文本的气球通知。

  4. 如果最终用户单击气球通知，操作系统将启动请求的 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 接口。 有关 PROPSHEETPAGE 结构的详细信息，请参阅Microsoft Windows SDK中的文档。

  5. 通过 IWizardSite COM 接口浏览 Native 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 以及指向包含响应数据的缓冲区的指针。

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

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