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 オペレーティング システムで使用できます。 |
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | wlanihv.h (Wlanihv.h を含む) |
関連項目
Dot11ExtAllocateBuffer の
Dot11ExtIhvInitAdapter の
Dot11ExtFreeBuffer の