(wlanihv.h) DOT11EXTIHV_PERFORM_POST_ASSOCIATE 回呼函式

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

 

操作系統會呼叫 Dot11ExtIhvPerformPostAssociate 函式，要求 IHV 擴充功能 DLL 起始與基本服務集的關聯後作業， (BSS) 網路。

語法

DOT11EXTIHV_PERFORM_POST_ASSOCIATE Dot11extihvPerformPostAssociate;

DWORD Dot11extihvPerformPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hSecuritySessionID,
  [in]           PDOT11_PORT_STATE pPortState,
  [in]           ULONG uDot11AssocParamsBytes,
  [in]           PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
)
{...}

參數

[in, optional] hIhvExtAdapter

IHV 延伸模組 DLL 用來參考無線 LAN (WLAN) 適配卡的句柄。 這個句柄值是透過 先前呼叫 Dot11ExtIhvInitAdapter IHV Handler 函式所指定。

[in, optional] hSecuritySessionID

安全性會話的句柄。 IHV 擴充功能 DLL 在呼叫時必須使用這個句柄值 Dot11ExtPostAssociateCompletion 以異步方式完成關聯後作業。

[in] pPortState

DOT11_PORT_STATE 結構的指標，指定安全性會話的目前埠狀態。

[in] uDot11AssocParamsBytes

透過 pDot11AssocParams 參數參考之數據的長度，以位元組為單位。

[in] pDot11AssocParams

的指標 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 結構，指定WLAN 配接器完成的關聯作業結果。 管理 WLAN 適配卡的 Native 802.11 迷你埠驅動程式包含DOT11_ASSOCIATION_COMPLETION_PARAMETERS結構 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 指示。

如需關聯作業的詳細資訊，請參閱 關聯作業。

傳回值

如果 IHV 擴充功能 DLL 可以起始關聯後作業，則必須以異步方式完成作業。 在此情況下，函式會傳回ERROR_SUCCESS。

如果 IHV 擴充功能 DLL 無法起始關聯後作業，則會傳回 Winerror.h 中定義的錯誤碼。

備註

操作系統會呼叫 Dot11ExtIhvPerformPostAssociate 函式，以使用 IHV 延伸模組 DLL 起始關聯後作業。 在WLAN適配卡在基礎結構基本服務集 (BSS) 網路中，與存取點 (AP) 完成關聯作業之後，操作系統就會起始此作業。

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

 

如需關聯作業的詳細資訊，請參閱 關聯作業。

從 對 Dot11ExtIhvPerformPostAssociate 的呼叫，必須以異步方式完成關聯後作業。 關聯後作業完成之後，DLL 必須呼叫 Dot11ExtPostAssociateCompletion。

如果 IHV 延伸模組 DLL 可以起始關聯後作業， Dot11ExtIhvPerformPostAssociate 函式必須傳回ERROR_SUCCESS並以異步方式完成作業。

如需關聯後作業的詳細資訊，請參閱 關聯後作業。

規格需求

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

另請參閱

Dot11ExtPostAssociateCompletion

Dot11ExtIhvInitAdapter

DOT11_PORT_STATE

Dot11ExtIhvAdapterReset

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION