共用方式為


DOT11EXT_POST_ASSOCIATE_COMPLETION wlanihv.h) (回呼函式

重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。 請改用 WLAN 設備驅動器介面 (WDI) 。 如需 WDI 的詳細資訊,請參閱 WLAN 通用 Windows 驅動程式模型

IHV 擴充功能 DLL 會呼叫 Dot11ExtPostAssociateCompletion 函 式,以異步方式完成透過呼叫 起始的關聯後作業 Dot11ExtIhvPerformPostAssociate IHV 處理程式函式。

語法

DOT11EXT_POST_ASSOCIATE_COMPLETION Dot11extPostAssociateCompletion;

DWORD Dot11extPostAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hSecuritySessionID,
  [in, optional] PDOT11_MAC_ADDRESS pPeer,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

參數

[in, optional] hDot11SvcHandle

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

[in, optional] hSecuritySessionID

安全性會話標識碼的句柄 (標識子) 透過先前呼叫傳回的 Dot11ExtIhvPerformPostAssociate IHV 處理程式函式。

[in, optional] pPeer

媒體訪問控制 (MAC) IHV 擴充功能 DLL 執行安全性作業的存取點 (AP) 位址。 此參數會格式化為 DOT11_MAC_ADDRESS 結構。

注意 針對 Windows Vista,IHV 擴充功能 DLL 僅支援基礎結構基本服務集 (BSS) 網路。

[in] dwReasonCode

值,提供關聯後作業完成狀態的其他資訊。 IHV 延伸模組 DLL 必須將 dwReasonCode 設定為L2_REASON_CODE_xxxx值,此值定義於 L2cmn.h 中。

IHV 延伸模組 DLL 會透過 dwWin32Error 參數傳回關聯後作業的一般完成狀態。 IHV 延伸模組 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 中定義的錯誤碼。

備註

IHV 擴充功能 DLL 會呼叫 Dot11ExtPostAssociateCompletion 函 式來執行下列任一動作:

  • 完成呼叫 所起始的關聯後作業 Dot11ExtIhvPerformPostAssociate IHV 處理程式函式。
  • 完成關聯後作業之後,表示 hSecuritySessionID 參數所參考之安全性會話的埠狀態變更。

    例如,如果埠的授權狀態變更,IHV 延伸模組 DLL 可以呼叫 Dot11ExtPostAssociateCompletion 來通知操作系統。

呼叫 Dot11ExtPostAssociateCompletion 函式時,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 將 dwWin32Error 設定為 ERROR_SUCCESS,操作系統會假設安全性會話的埠狀態處於授權狀態。 在埠處於授權狀態之後,操作系統允許透過 WLAN 配接器傳送所有數據封包。
     
  • 如果關聯後作業完成失敗,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 中定義的適當錯誤碼。
    注意 如果 IHV 擴充功能 DLL 未將 dwWin32Error 設定為 ERROR_SUCCESS,操作系統會假設安全性會話的埠狀態處於未經授權的狀態。 在埠處於未經授權的狀態之後,操作系統允許安全性封包,包括透過 Dot11ExtSendPacket IHV Extensions 函式傳送的封包,以透過 WLAN 適配卡傳送。
     
  • 每當呼叫 Dot11ExtIhvAdapterResetDot11ExtIhvAdapterReset 或 Dot11ExtIhvDeinitAdapter IHV 處理程式函式時,IHV 延伸模組 DLL 必須呼叫 Dot11ExtExtPostAssociateCompletion 來取消所有擱置的後關聯作業。 在此情況下,DLL 必須將 dwStatus 參數設定為 ERROR_CANCELLED。

規格需求

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

另請參閱

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

原生 802.11 IHV 處理程式函式

Dot11ExtIhvPerformPostAssociate

DOT11_MAC_ADDRESS

Dot11ExtSendPacket