ワイヤレス セキュリティ プロパティの拡張
このトピックでは、Native 802.11 IHV UI 拡張機能 DLL がネットワーク構成ユーザー インターフェイス (UI) を経由して表示する [セキュリティ] タブのプロパティを拡張する方法について説明します。 このような状況では、Native 802.11 IHV UI 拡張機能 DLL は、Native 802.11 802.1X モジュールから相互に排他的な独自のセキュリティ設定の [セキュリティ] タブにプロパティを追加します。
Native 802.11 IHV UI Extensions DLL では、Native 802.11 802.1X モジュールでサポートされているセキュリティと暗号化の方法の拡張もできます。 DLL の動作の詳細については、「Microsoft 802.1X セキュリティ 設定の拡張」をご覧ください。
ネットワーク構成 UI とその他のNative 802.11 コンポーネントについて詳しくは、「Native 802.11 ソフトウェア アーキテクチャ」をご覧ください。
[セキュリティ] タブが表示される前に、オペレーティング システムによって次の処理を行います。
IDot11ExtUI::GetDot11ExtUIProperties メソッドの呼び出しを通して、ネイティブ 802.11 IHV UI 拡張機能 DLL のセキュリティ プロパティ拡張を照会します。 オペレーティング システムは、DOT11_EXT_UI_SECURITY の値をメソッドの ExtType パラメーターに渡します。
Native 802.11 IHV UI Extension DLL が DOT11_EXT_UI_Standard Edition CURITY 型の プロパティを1つ以上サポートしている場合、DLL は (メソッドの ppDot11ExtUIProperty パラメーターを使用して) DLL でサポートされているセキュリティ プロパティ拡張機能の IDot11ExtUIProperty COM インターフェイスの一覧を返します。 セキュリティ プロパティの拡張に使用される COM インターフェイスの詳細は、「Native 802.11 IHV UI Extensions COM インターフェイス」をご覧ください。
拡張機能の IDot11ExtUIProperty::GetDot11ExtUIPropertyFriendlyName メソッドを呼び出して、セキュリティ拡張機能のフレンドリ名を照会します。 オペレーティング システムによって、[セキュリティ] タブの下部にある独自のセキュリティ設定の一覧にフレンドリ名を追加します。
エンド ユーザーがこのリストから項目を選択すると、オペレーティング システムは、各セキュリティ拡張機能の IDot11ExtUIProperty COM インターフェイスの IDot11ExtUIProperty::D ot11ExtUIPropertyGetSelected メソッドを呼び出します。 メソッドの pfIsSelected パラメーターに対して TRUE の値を指定して返される最初の拡張機能は、選択した拡張機能であると判断されます。 一覧で選択したエントリがハイライトで表示されます。
選択した設定のの IDot11ExtUIProperty::D ot11ExtUIPropertyHasConfigurationUI メソッドを照会し、表示できるカスタム UI プロパティ ページがあるかを判断します。 fHasConfigurationUI パラメーターを TRUE に設定してメソッドが返されると、オペレーティング システムによって独自のセキュリティ設定の一覧の横に [構成] ボタンが追加されます。
選択した独自のセキュリティ設定で構成 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 に設定します。