DOT11EXTIHV_PERFORM_PRE_ASSOCIATE回呼函式 (wlanihv.h)

發行項
03/01/2024

重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。請改用 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 結構的指標，其中包含一或多個 802.11 指標或探查回應框架，用於服務集標識碼 (SSID) ，DLL 會用來執行預先關聯作業的 BSS 網路。

[out] pdwReasonCode

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

傳回值

如果 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錯誤值。
- 範圍中的 IHV 定義值，從 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) ，不論是否可以起始預先關聯作業。

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

規格需求

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