次の方法で共有

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

  • [アーティクル]

 

このトピックでは、Native 802.11 IHV UI 拡張機能 DLL がネットワーク構成ユーザー インターフェイス (UI) を経由して表示する [接続] タブのプロパティを拡張する方法について説明します。 このような状況で、Native 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 Extension DLL がDOT11_EXT_UI_CONNECTION型のプロパティをサポートしている場合、DLL は (メソッドの ppDot11ExtUIProperty パラメーターを使用して) IDot11ExtUIProperty COM インターフェイスのアドレスを返します。これは接続プロパティ拡張機能を実装します。 接続プロパティの拡張に使用される COM インターフェイスの詳細には、「Native 802.11 IHV UI 拡張機能 COM インターフェイス」をご覧ください。

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

     

  2. Native 802.11 IHV UI Extensions DLL で接続プロパティがサポートされている場合、オペレーティング システムは拡張機能の Dot11ExtUIProperty::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 に設定します。