次の方法で共有

プロファイルとコンテキスト データへのアクセス

  • [アーティクル]

 

Native 802.11 IHV UI 拡張機能 DLL でサポートされているカスタム ユーザー インターフェイス (UI) は、次のいずれかを使用して表示できます。

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

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

バルーン通知またはオペレーティング システムのネットワーク接続ウィザードを通じて UI 要求が表示されるかどうかにかかわらず、ネイティブ 802.11 IHV UI 拡張機能 DLL は次のデータにアクセスできます。

ネットワーク接続プロファイル データ
カスタム UI がネットワーク接続ウィザード内に表示されている場合、ネイティブ 802.11 IHV UI 拡張機能 DLL は、現在のネットワーク接続プロファイルの IHV 定義部分にアクセスできます。 このデータは、<IHV></IHV> XML タグで囲まれた XML フラグメントとして書式設定されます。 これらのタグ内の XML データは IHV の実装に固有であり、オペレーティング システムに対して不透明です。

プロファイル データへのアクセスは、IHV_PROFILE_DATA という名前のプロパティの IPropertyBag COM インターフェイスの Read メソッドと Write メソッドを使用します。

コンテキスト データ
ネイティブ 802.11 IHV 拡張機能 DLL は、Dot11ExtSendUIRequest 関数と Dot11ExtIhvQueryUIRequest 関数の両方で引数として渡される DOT11EXT_IHV_UI_REQUEST 構造体を介してカスタム UI を指定します。 DOT11EXT_IHV_UI_REQUEST 構造体内では、IHV はカスタム UI に固有の コンテキスト データを (pvUIRequest メンバーを介して) 提供できます。 通常、IHV はカスタム UI の既定の設定でこのデータを書式設定します。

プロファイル データへのアクセスは、IHV_NOTIFICATION_DATA という名前のプロパティの IPropertyBag COM インターフェイスの Read メソッドと Write メソッドを使用します。

ネイティブ 802.11 IHV UI 拡張機能 DLL は、IObjectWithSite::SetSite メソッドから返された IUnknown ポインターを介して IPropertyBag COM インターフェイスにアクセスします。 詳細については、「IObjectWithSite」を参照してください。

IPropertyBag COM インターフェイスの代わりに、ネイティブ 802.11 IHV UI 拡張機能 DLL は、GetProp Win32 関数を使用して IHV_PROFILE_DATA および IHV_NOTIFICATION_DATA プロパティにアクセスできます。 この状況では、次の例に示すように、DLL は親ウィンドウのハンドルを使用する必要があります。

LPWSTR lpszBuffer = (LPWSTR) GetProp(GetParent(hwndDlg), L"IHV_PROFILE_DATA");