共用方式為

DOT11EXT_PRE_ASSOCIATE_COMPLETION回呼函式 (wlanihv.h)

  • 發行項
重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。 請改用 WLAN 設備驅動器介面 (WDI) 。 如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。
 
IHV 延伸模組 DLL 會呼叫 Dot11ExtPreAssociateCompletion 函式，以異步方式完成透過呼叫起始的預先關聯作業 Dot11ExtIhvPerformPreAssociate IHV 處理程式函式。

語法

DOT11EXT_PRE_ASSOCIATE_COMPLETION Dot11extPreAssociateCompletion;

DWORD Dot11extPreAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

參數

[in, optional] hDot11SvcHandle

操作系統用來參考無線 LAN (WLAN) 適配卡的句柄。 這個句柄值是透過 先前呼叫 Dot11ExtIhvInitAdapter IHV Handler 函式來指定。

[in, optional] hConnectSession

操作系統用來參考聯機會話與基本服務集的句柄， (BSS) 網路。 這個句柄值是透過先前對的呼叫所指定 Dot11ExtIhvPerformPreAssociate IHV 處理程式函式。

[in] dwReasonCode

值，提供預先關聯作業完成狀態的其他資訊。 IHV Extensions DLL 必須將 dwReasonCode 設定為 L2_REASON_CODE_xxxx 值，這些值定義於 L2cmn.h 中。

IHV 延伸模組 DLL 會透過 dwWin32Error 參數傳回預先關聯作業的一般完成狀態。 一般而言，IHV Extensions DLL 會將 dwReasonCode 設定為範圍中的值，範圍從 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) 。

[in] dwWin32Error

由 Winerror.h 內錯誤碼所定義的預先關聯作業完成狀態。 如果作業順利完成，IHV 延伸模組 DLL 必須將 dwWin32Error 設定為 ERROR_SUCCESS。

傳回值

如果呼叫成功，函式會傳回ERROR_SUCCESS。 否則，它會傳回 Winerror.h 中定義的錯誤碼。

備註

呼叫 Dot11ExtPreAssociateCompletion 函式時，IHV 延伸模組 DLL 必須遵循這些指導方針。

  • 如果預先關聯作業成功完成，IHV 延伸模組 DLL 必須將 dwReasonCode 設定為下列其中一項：
    • L2_REASON_CODE_SUCCESS。
    • 範圍中的 IHV 定義值，範圍從 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) 。
    在此情況下，IHV 延伸模組 DLL 必須將 dwWin32Error 設定為 ERROR_SUCCESS。
  • 如果預先關聯作業完成失敗，IHV 延伸模組 DLL 不得將 dwReasonCode 設定為 L2_REASON_CODE_SUCCESS。 相反地，DLL 必須將 dwReasonCode 設定為下列其中一項：
    • 適當的L2_REASON_CODE_xxxx錯誤值。
    • 範圍中的 IHV 定義值，範圍從 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) 。
    在此情況下，IHV 延伸模組 DLL 不得將 dwWin32Error 設定為 ERROR_SUCCESS。 相反地，DLL 必須將 dwWin32Error 設定為 Winerror.h 中定義的適當錯誤碼
  • 每當呼叫 Dot11ExtIhvAdapter IHV 處理程式函式時，IHV 延伸模組 DLL 必須呼叫 Dot11ExtPreAssociateCompletion 來取消所有暫止的預先關聯作業。 在此情況下，DLL 必須將 dwWin32Error 參數設定為 ERROR_CANCELLED。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台 桌面
標頭 wlanihv.h (包含 Wlanihv.h)

另請參閱

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

原生 802.11 IHV 處理程式函式

Dot11ExtIhvPerformPreAssociate