次の方法で共有

バルーン通知内でのカスタム UI ページの表示

  • [アーティクル]

 

Native 802.11 IHV Extensions DLL が Dot11ExtSendUIRequest呼び出してカスタム ユーザー インターフェイス (UI) を表示する場合、ワイヤレス LAN (WLAN) アダプターがワイヤレス ネットワークに接続されている場合、オペレーティング システムはクリック可能なバルーン通知を介して UI を表示します。 この状況では、カスタム UI の要求がバルーン通知として表示されます。

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

  • オペレーティング システムが DLL の Dot11ExtIhvAdapterReset IHV ハンドラー関数を呼び出して WLAN 接続をリセットする前に。

Native 802.11 IHV Extensions DLL がカスタム UI の表示を要求する方法の詳細については、「カスタム UIの表示を要求する」を参照してください。

カスタム UI 要求をバルーン通知として処理する場合、オペレーティング システムは次の処理を行います。

  1. ネイティブ 802.11 IHV 拡張機能 DLL の Dot11ExtIhvIsUIRequestPending IHV ハンドラー関数を呼び出して、UI 要求がまだ保留中かどうかを判断します。 オペレーティング システムは、ネイティブ 802.11 IHV 拡張機能 DLL によって Dot11ExtSendUIRequest に渡されるグローバル一意識別子 (GUID) を使用して UI 要求を指定します。

  2. Dot11ExtIhvIsUIRequestPending指定した UI 要求 TRUE を返す場合、オペレーティング システムは Native 802.11 IHV UI Extensions DLL の IDot11ExtUI::GetDot11ExtUIBalloonText メソッドを呼び出します。 このメソッドを使用して、DLL は、バルーン通知内に表示されるローカライズされたテキストを含む文字列バッファーを返します。

  3. ローカライズされたテキストを含むバルーン通知を表示します。

  4. エンド ユーザーがバルーン通知をクリックすると、オペレーティング システムは、要求された 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 ページを表す PROPSHEETPAGE 構造体のハンドルの配列を返します。

    IWizardExtension COM インターフェイスの詳細については、IWizardExtension COM インターフェイス を参照してください。 PROPSHEETPAGE 構造体の詳細については、Microsoft Windows SDK のドキュメントを参照してください。

  5. 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 統合 DLL 呼び出し WlanSendUIResponse後、オペレーティング システムは Native 802.11 IHV 拡張 DLL の Dot11ExtIhvProcessUIResponse IHV ハンドラー関数を呼び出して、カスタム UI 用の応答データを転送します。

WlanSendUIResponse API の詳細については、Windows SDK のドキュメントを参照してください。