擴充無線連線屬性
本主題描述原生 802.11 IHV UI 延伸模組 DLL 如何擴充 [ 連線 ] 索引標籤上透過 [網路設定] 使用者介面顯示的屬性, (UI) 。 在此情況下,Native 802.11 IHV UI 延伸模組 DLL 會將屬性新增至專屬連線設定的 [ 連線 ] 索引標籤。
如需網路設定 UI 和其他原生 802.11 元件的詳細資訊,請參閱 原生 802.11 軟體架構。
在顯示 [ 連線 ] 索引標籤之前,作業系統會執行下列動作:
透過呼叫 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 介面 。
如果 Native 802.11 IHV UI Extensions DLL 支援連線屬性,作業系統會呼叫擴充功能的 IDot11ExtUIProperty::GetDot11ExtUIPropertyFriendlyName 方法,以查詢屬性延伸模組的易記名稱。 作業系統會在 「Enable xxx connection settings」 文字中插入易記名稱,其中 「xxx」 是屬性延伸模組的易記名稱。 作業系統會在 [ 連線 ] 索引標籤上顯示此文字以及核取方塊。
查詢延伸模組,以判斷它是否有可顯示的自訂 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。