次の方法で共有

バルーン通知内のカスタム 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. Native 802.11 IHV 拡張機能 DLL の Dot11ExtIhvIsUIRequestPending IHV ハンドラー関数を呼び出して、UI リクエストがまだ保留中かを判断します。 オペレーティング システムは、Native 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 ページを意味する PROPSH Enterprise Edition TPAGE 構造体のハンドルの配列を返します。

    IWizardExtension COM インターフェイスの詳細については、「IWizardExtension COM インターフェイス」を参照してください。 PROPSH Enterprise Edition TPAGE 構造体の詳細は、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 Extensions DLLがWlanSendUIResponse を呼び出した後、オペレーティング システムはNative 802.11 IHV 拡張 DLL の Dot11ExtIhvProcessUIResponse IHV ハンドラー関数を呼び出して、カスタム UI の応答データを転送します。

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