共用方式為

擴充無線連線屬性

  • 發行項

 

本主題描述原生 802.11 IHV UI 延伸模組 DLL 如何擴充透過網路組態使用者介面（UI）所顯示的 [連線] 索引標籤上的屬性。 在此情況下，原生 802.11 IHV UI 延伸模組 DLL 會將屬性添加到專有連線設定的 [連線] 標籤頁。

如需網路設定 UI 和其他 Native 802.11 元件的詳細資訊，請參閱 Native 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 介面。

    注意 Windows Vista，原生 802.11 IHV UI 延伸模組 DLL 不得針對連線屬性延伸模組傳回一個以上的 IDot11ExtUI COM 介面。

     

  2. 如果 Native 802.11 IHV UI Extensions DLL 支援某連線屬性，作業系統會透過呼叫擴充模組的 IDot11ExtUIProperty::GetDot11ExtUIPropertyFriendlyName 方法，來查詢該屬性擴充的易記名稱。 作系統會在 [啟用 xxx 連線設定] 文字中插入易記名稱，其中 “xxx” 是屬性延伸模組的易記名稱。 作業系統會在 [連線] 索引標籤上顯示此文字及複選框。

  3. 查詢延伸模組，以判斷其是否具有可顯示的自定義UI屬性。 作業系統會藉由呼叫擴充功能的 IDot11ExtUIProperty::Dot11ExtUIPropertyHasConfigurationUI 方法來執行此作業。 如果連接屬性延伸模組支援自訂 UI 屬性，作業系統會在屬性的複選框下方新增 [設定] 按鈕。

如果選取的專屬連線設定支援組態 UI，且使用者按一下 [連線] 索引標籤中的 [設定] 按鈕，作業系統會呼叫連線屬性延伸模組的 IDot11ExtUIProperty::DisplayDot11ExtUIProperty 方法來啟動自訂 UI。 作業系統會透過方法的 bstrIHVProfile 引數，傳遞延伸模組的目前設定檔數據。

配置文件數據會格式化為 <IHV></IHV> XML 標籤所系結的 XML 片段。 這些標籤內的 XML 資料是 IHV 實作特有的，而且對作系統不透明。 如需 Native 802.11 設定檔數據格式的詳細資訊，請參閱 Microsoft Windows SDK 中的檔。

如果設定檔資料是透過自定義 UI 變更，擴充功能的 IDot11ExtUIProperty: DisplayDot11ExtUIProperty 方法必須執行以下動作後才能返回：

  • 為修改過的配置檔數據配置字串緩衝區，並透過方法的 bstrModifiedIHVProfile 參數傳回緩衝區的指標。 附註 擴展模組的 IDot11ExtUIProperty::DisplayDot11ExtUIProperty 方法不能修改 bstrIHVProfile 參數所參考的數據。

     

  • 將 pbIsModified 自變數設定為 TRUE。