次の方法で共有

ネットワーク接続ウィザード内のカスタム UI ページの表示

  • [アーティクル]

 

Native 802.11 IHV UI 拡張機能 DLL がサポートしているカスタム ユーザー インターフェイス (UI) は、次のいずれかを使用して UI のリクエストが行われると、オペレーティング システムのネットワーク接続ウィザード内に表示できます。

  • Native 802.11 IHV 拡張機能 DLL によって実行した Dot11ExtSendUIRequest の呼び出し。 このプロセスの詳細については、「カスタム UI の表示の要求」を参照してください。

  • オペレーティング システムによって実行した、Native 802.11 IHV 拡張機能 DLL の Dot11ExtQueryUIRequest IHV ハンドラー関数の呼び出し。 このプロセスの詳細については、「カスタム UI の表示のクエリ」を参照してください。

ワイヤレス LAN (WLAN) アダプターがワイヤレス ネットワークへの接続を試行している場合、オペレーティング システムはネットワーク接続ウィザード内にカスタム UI を表示します。 この状況では、カスタム UI のリクエストを期間内にバルーン通知として表示します。

  • オペレーティング システムがNative 802.11 IHV 拡張機能 DLL の Dot11ExtIhvPerformPreAssociate IHV ハンドラー関数を呼び出して、ワイヤレス ネットワークとの事前関連付け操作を開始した後。

  • Native 802.11 IHV Extensions DLL が Dot11ExtPostAssociateCompletion を呼び出した後、関連付け後の操作は正常に完了します。

ネットワーク接続ウィザード内にカスタム UI リクエストを挿入すると、オペレーティング システムによって次の処理を実行します。

  1. Native 802.11 IHV 拡張機能 DLL の Dot11ExtIhvIsUIRequestPending IHV ハンドラー関数を呼び出して、UI リクエストがまだ保留中かを判断します。 オペレーティング システムは、Native 802.11 IHV 拡張機能 DLL がDot11ExtSendUIRequest に譲渡するグローバル一意識別子 (GUID) を使用して UI リクエストを指定します。

  2. Dot11ExtIhvIsUIRequestPending が指定された UI リクエストに対して TRUE を返した場合、オペレーティング システムはリクエストされた IWizardExtension COM インターフェイスをインスタンス化し、ネットワーク接続ウィザードの現在の UI フローにバインドします。 Dot11ExtSendUIRequest を呼び出すと、Native 802.11 IHV Extensions DLL は、Native 802.11 IHV UI Extensions DLL 内で IWizardExtension 実装のクラス識別子 (CLSID) を指定します。

    また、オペレーティング システムが IWizardExtension::AddPages メソッドを呼び出すのを通して、Native 802.11 IHV UI Extensions DLL は、カスタム UI ページを意味する PROPSH Enterprise Edition TPAGE 構造体のハンドルの配列を返します。

    IWizardExtension COM インターフェイスの詳細については、「IWizardExtension COM インターフェイス」を参照してください。

  3. IWizardSite COM インターフェイスを経由して、Native 802.11 IHV UI 拡張機能 DLL が制御するUI ページ間を移動します。 このインターフェイスの詳細については、「IWizardSite COMインターフェイス」をご覧ください 。

カスタム UI が表示されている間、Native 802.11 IHV UI Extensions DLL は IPropertyBag COM インターフェイスを経由してコンテキスト固有のデータを読み書きすることが可能です。 このプロセスの詳細は「プロファイルおよびコンテキスト データへのアクセス」をご覧ください。

カスタム UI が表示されるとNative 802.11 IHV UI Extensions DLL は、WlanSendUIResponse を呼び出してユーザーが入力した応答データを Native 802.11 IHV Extensions DLL に返すことができます。 DLL は、UI リクエストの GUID と応答データを含むバッファーへのポインターを譲渡します。

Native 802.11 IHV UI Extensions DLLがWlanSendUIResponse を呼び出した後、オペレーティング システムはNative 802.11 DLL 拡張 IHV の Dot11ExtIhvProcessUIResponse IHV ハンドラー関数を呼び出し、カスタム UI の応答データを転送します。

WlanSendUIResponse API の詳細は、Microsoft Windows SDK のドキュメントをご覧ください。