共用方式為


擴充無線連線屬性

 

本主題描述原生 802.11 IHV UI 延伸模組 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 參數傳回 () IDot11ExtUIPropertyCOM 介面的位址,以實作連接屬性延伸模組。 如需用來擴充連線屬性之 COM 介面的詳細資訊,請參閱 原生 802.11 IHV UI 延伸模組 COM 介面

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

     

  2. 如果 Native 802.11 IHV UI Extensions DLL 支援連線屬性,作業系統會呼叫擴充功能的 IDot11ExtUIProperty::GetDot11ExtUIPropertyFriendlyName 方法,以查詢屬性延伸模組的易記名稱。 作業系統會在 「Enable xxx connection settings」 文字中插入易記名稱,其中 「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