DOT11EXTIHV_PERFORM_PRE_ASSOCIATE回呼函式（wlanihv.h）

發行項
02/07/2025

重要 Windows 10 和更新版本中已淘汰 Native 802.11 無線 LAN 介面。請改用 WLAN 裝置驅動器介面（WDI）。如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。

作系統會呼叫 Dot11ExtIhvPerformPreAssociate 函式，要求 IHV 延伸模組 DLL 起始與基本服務集（BSS）網路的預先關聯作業。

語法

DOT11EXTIHV_PERFORM_PRE_ASSOCIATE Dot11extihvPerformPreAssociate;

DWORD Dot11extihvPerformPreAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in]           PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDWORD pdwReasonCode
)
{...}

參數

[in, optional] hIhvExtAdapter

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

[in, optional] hConnectSession

作系統用來參考聯機會話與基本服務集（BSS）網路的句柄。

[in, optional] pIhvProfileParams

的指標 DOT11EXT_IHV_PROFILE_PARAMS 結構。此結構會定義將套用配置檔擴充功能之基本服務集（BSS）網路的屬性。

[in] pIhvConnProfile

的指標 DOT11EXT_IHV_CONNECTIVITY_PROFILE 結構，其中包含 IHV 配置檔的連線設定。

[in] pIhvSecProfile

的指標 DOT11EXT_IHV_SECURITY_PROFILE 結構，指定 IHV 設定檔的安全性設定。

[in] pConnectableBssid

DOT11_BSS_LIST 結構的指標，其中包含 BSS 網路服務集標識碼（SSID）的一或多個 802.11 指標或探查回應框架，DLL 會執行預先關聯作業。

[out] pdwReasonCode

DWORD 值的指標，提供 Dot11ExtIhvPerformPreAssociate 函式傳回值的其他資訊。 IHV 延伸模組 DLL 必須將 * pdwReasonCode 設定為 L2cmn.h 中定義的L2_REASON_CODE_xxxx值。

傳回值

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

如果 IHV 延伸模組 DLL 無法起始預先關聯作業，它會傳回在 Winerror.h中定義的錯誤碼。

言論

作系統會呼叫 Dot11ExtIhvPerformPreAssociate 函式，以起始與 IHV 延伸模組 DLL 的預先關聯作業。作系統會先起始此作業，再透過WLAN適配卡起始與基本服務集（BSS）網路的連線作業。如需連線作業的詳細資訊，請參閱連接作業。

預先關聯作業必須從呼叫 Dot11ExtIhvPerformPreAssociate異步完成。在預先關聯作業完成之後，IHV 延伸模組 DLL 必須呼叫 Dot11ExtPreAssociateCompletion。

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

如果 IHV 延伸模組 DLL 可以起始預先關聯作業，Dot11ExtIhvPerformPreAssociate 函式必須傳回ERROR_SUCCESS並以異步方式完成作業。
IHV 延伸模組 DLL 提供透過 pdwReasonCode 參數起始預先關聯作業的詳細資訊。 DLL 必須將 * pdwReasonCode 設為下列其中一項：
- L2_REASON_CODE_SUCCESS，如果預先關聯作業可以成功起始。
- 如果無法起始預先關聯作業，則為適當的L2_REASON_CODE_xxxx錯誤值。
- 從 L2_REASON_CODE_IHV_BASE 到（L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1）範圍內的 IHV 定義值，無論是否可以起始預先關聯作業。

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

要求

要求	價值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows作系統中使用。
目標平臺	桌面
標頭	wlanihv.h （包括 Wlanihv.h、L2cmn.h）