DOT11EXTIHV_QUERY_UI_REQUEST コールバック関数 (wlanihv.h)

構文

DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

DWORD Dot11extihvQueryUiRequest(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
  [out]          PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}

パラメーター

[in, optional] hIhvExtAdapter

ワイヤレス LAN (WLAN) アダプターを参照するために IHV 拡張機能 DLL によって使用されるハンドル。 このハンドル値は、 Dot11ExtIhvInitAdapter IHV ハンドラー関数の以前の呼び出しによって指定されました。

[in] connectionPhase

現在の接続フェーズ。 このメンバーのデータ型は、 DOT11EXT_IHV_CONNECTION_PHASE 列挙です。

connection_phase_any

任意の接続フェーズを指定します。

connection_phase_initial_connection

IHV 拡張機能 DLL が事前関連付け操作を開始する前の接続フェーズを指定します。 関連付け前操作の詳細については、「関連付け 前操作」を参照してください。

connection_phase_post_l3_connection

IHV 拡張機能 DLL が関連付け後の操作を完了した後の接続フェーズを指定します。 関連付け後操作の詳細については、「関連付け 後の操作」を参照してください。

[out] ppIhvUIRequest

DOT11EXT_IHV_UI_REQUEST構造体へのポインターのアドレス。 IHV 拡張機能 DLL は、 Dot11ExtAllocateBuffer を呼び出して、DOT11EXT_IHV_UI_REQUEST構造体のバッファーを割り当てる必要があります。

戻り値

呼び出しが成功した場合、関数は ERROR_SUCCESSを返します。 それ以外の場合は、Winerror.h で定義されたエラー コードが返されます。

注釈

Dot11ExtIhvQueryUIRequest が呼び出されると、IHV 拡張機能 DLL は、DOT11EXT_IHV_UI_REQUEST構造体として書式設定されたバッファーを割り当てて返す必要があります。 この状況では、DLL は次のガイドラインに従う必要があります。

• IHV 拡張機能 DLL は、バッファーを割り当てるために Dot11ExtAllocateBuffer を呼び出す必要があります。 DLL が Dot11ExtIhvQueryUIRequest から戻った後、オペレーティング システムは Dot11ExtFreeBuffer を呼び出してバッファーを解放します。
• IHV 拡張機能 DLL は、接続状態の変更に適した UI 要求の DOT11EXT_IHV_UI_REQUEST 構造を書式設定します。

  たとえば、 connectionPhase が connection_phase_initial_connection に設定されている場合、IHV 拡張機能 DLL は、接続操作の開始をユーザーに通知するユーザー インターフェイス ページを参照するように、DOT11EXT_IHV_UI_REQUEST構造体のメンバーを設定できます。

要件

こちらもご覧ください

Dot11ExtAllocateBuffer

DOT11EXT_IHV_UI_REQUEST

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer