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構造体のメンバーを設定できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | wlanihv.h (Wlanihv.h を含む) |