通过

扩展无线连接属性

  • 项目

 

本主题介绍 Native 802.11 IHV UI Extensions DLL 如何扩展“ 连接 ”选项卡上的属性，这些属性通过网络配置用户界面 (UI) 显示。 在这种情况下，Native 802.11 IHV UI 扩展 DLL 向“ 连接 ”选项卡添加属性，用于专有连接设置。

有关网络配置 UI 和其他本机 802.11 组件的详细信息，请参阅 本机 802.11 软件体系结构。

在显示“ 连接 ”选项卡之前，操作系统将执行以下操作：

  1. 通过调用 IDot11ExtUI：：GetDot11ExtUIProperties 方法，查询 Native 802.11 IHV UI 扩展 DLL 的连接属性。 操作系统将 值 DOT11_EXT_UI_CONNECTION 传递给方法的 ExtType 参数。

    如果 Native 802.11 IHV UI 扩展 DLL 支持 DOT11_EXT_UI_CONNECTION 类型的属性，则 DLL 通过方法的 ppDot11ExtUIProperty 参数返回 (，) 实现连接属性扩展的 IDot11ExtUIProperty COM 接口的地址。 有关用于扩展连接属性的 COM 接口的详细信息，请参阅 Native 802.11 IHV UI Extensions COM Interfaces。

    注意 对于 Windows Vista，本机 802.11 IHV UI 扩展 DLL 不得返回连接属性扩展的多个 IDot11ExtUI COM 接口 。

     

  2. 如果 Native 802.11 IHV UI 扩展 DLL 支持连接属性，则操作系统将通过调用扩展的 IDot11ExtUIProperty：：GetDot11ExtUIPropertyFriendlyName 方法查询属性扩展的友好名称。 操作系统在文本“启用 xxx 连接设置”中插入友好名称，其中“xxx”是属性扩展的友好名称。 操作系统在“连接”选项卡上显示此文本以及检查框。

  3. 查询扩展以确定它是否具有可显示的自定义 UI 属性。 操作系统通过调用扩展的 IDot11ExtUIProperty：:D ot11ExtUIPropertyHasConfigurationUI 方法执行此操作。 如果连接属性扩展支持自定义 UI 属性，则操作系统会在属性检查框下方添加“配置”按钮。

如果所选专有连接设置支持配置 UI，并且最终用户单击“连接”选项卡中的“配置”按钮，则操作系统将调用连接属性扩展的 IDot11ExtUIProperty：:D isplayDot11ExtUIProperty 方法来启动自定义 UI。 操作系统通过方法的 bstrIHVProfile 参数传递扩展的当前配置文件数据。

配置文件数据的格式设置为由 IHV/IHV<>> XML 标记绑定的 <XML 片段。 这些标记中的 XML 数据特定于 IHV 的实现，对操作系统是不透明的。 有关 Native 802.11 配置文件数据格式的详细信息，请参阅Microsoft Windows SDK中的文档。

如果通过自定义 UI 更改配置文件数据，则扩展的 IDot11ExtUIProperty：:D isplayDot11ExtUIProperty 方法必须在返回之前执行以下操作：

  • 为修改后的配置文件数据分配字符串缓冲区，并通过方法的 bstrModifiedIHVProfile 参数返回指向缓冲区的指针。 注意 扩展的 IDot11ExtUIProperty：:D isplayDot11ExtUIProperty 方法不得修改 bstrIHVProfile 参数引用的数据。

     

  • 将 pbIsModified 参数设置为 TRUE。