次の方法で共有

ワイヤレス接続プロパティの拡張

 

このトピックでは、Native 802.11 IHV UI Extensions DLL が、ネットワーク構成ユーザー インターフェイス (UI) を介して表示される [接続] タブのプロパティを拡張する方法について説明します。 このような状況では、ネイティブ 802.11 IHV UI 拡張機能 DLL は、独自の接続設定の [接続] タブにプロパティを追加します。

ネットワーク構成 UI とその他のネイティブ 802.11 コンポーネントの詳細については、「Native 802.11 ソフトウェア アーキテクチャ」を参照してください。

[接続] タブが表示される前に、オペレーティング システムは次の操作を行います。

  1. IDot11ExtUI::GetDot11ExtUIProperties メソッドを呼び出して、Native 802.11 IHV UI Extensions DLL の接続プロパティを照会します。 オペレーティング システムは、DOT11_EXT_UI_CONNECTION の値をメソッドの ExtType パラメーターに渡します。

    Native 802.11 IHV UI Extension DLL が DOT11_EXT_UI_CONNECTION型のプロパティをサポートしている場合、DLL は (メソッドの ppDot11ExtUIProperty パラメーターを使用して) IDot11ExtUIProperty COM インターフェイスのアドレスを返します。これは、接続プロパティ拡張機能を実装します。 接続プロパティの拡張に使用される COM インターフェイスの詳細については、「Native 802.11 IHV UI Extensions COM Interfacesを参照してください。

    注 Windows Vista の場合、Native 802.11 IHV UI Extensions DLL は、接続プロパティ拡張機能の IDot11ExtUI COM インターフェイス を複数返してはなりません。

     

  2. Native 802.11 IHV UI Extensions DLL で接続プロパティがサポートされている場合、オペレーティング システムは拡張機能の IDot11ExtUIProperty::GetDot11ExtUIPropertyFriendlyName メソッドを呼び出して、プロパティ拡張機能のフレンドリ名を照会します。 オペレーティング システムは、"enable xxx connection settings" というテキスト内にフレンドリ名を挿入します。ここで、"xxx" はプロパティ拡張機能のフレンドリ名です。 オペレーティング システムは、[接続] タブのチェック ボックスと共にこのテキストを表示します。

  3. 拡張機能に対してクエリを実行して、表示できるカスタム UI プロパティがあるかどうかを判断します。 オペレーティング システムは、拡張機能の IDot11ExtUIProperty::Dot11ExtUIPropertyHasConfigurationUI メソッドを呼び出すことによってこれを行います。 接続プロパティ拡張機能でカスタム 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に設定します。

 

 

  • Last updated on