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
IHV 延伸模組 DLL 用來參考無線 LAN (WLAN) 適配卡的句柄。 這個句柄值是透過先前呼叫 dot11ExtIhvInitAdapter IHV Handler 函式來指定。
[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 來配置緩衝區。 從 Dot11ExtIhvQueryUIRequest傳回 DLL 之後,作系統會負責呼叫 Dot11ExtFreeBuffer 釋放緩衝區。
-
IHV 延伸模組 DLL 會將適用於連線狀態變更的 UI 要求 DOT11EXT_IHV_UI_REQUEST 結構格式化。
例如,如果 connectionPhase 設定為 connection_phase_initial_connection,IHV Extensions DLL 可以設定 DOT11EXT_IHV_UI_REQUEST 結構的成員,以參考使用者介面頁面,通知用戶連線作業的開始。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
目標平臺 | 桌面 |
標頭 | wlanihv.h (包括 Wlanihv.h) |