DOT11EXT_ONEX_START回呼函式 (wlanihv.h)

發行項
05/23/2024

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

IHV 延伸模組 DLL 會呼叫 Dot11ExtStartOneX 函式，以使用存取點 (AP) 起始 802.1X 驗證作業。在此情況下，驗證是由原生 802.11 架構的 802.1X 模組所管理，而不是由 IHV 延伸模組 DLL 管理。

語法

DOT11EXT_ONEX_START Dot11extOnexStart;

DWORD Dot11extOnexStart(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] EAP_ATTRIBUTES *pEapAttributes
)
{...}

參數

[in, optional] hDot11SvcHandle

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

[in, optional] pEapAttributes

包含驗證會話所傳回之 EAP 屬性之EAP_ATTRIBUTES數位結構的指標。如需EAP_ATTRIBUTES的詳細資訊，請參閱 Microsoft Windows SDK 檔。

傳回值

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

備註

IHV 延伸模組 DLL 可以使用原生 802.11 架構的 802.1X 模組來起始 802.1X 驗證作業。這可讓 DLL 使用作業系統所支援的標準可延伸驗證通訊協定 (EAP) 演算法。

IHV 延伸模組 DLL 會呼叫 Dot11ExtStartOneX 函式來起始 802.1X 驗證作業。 Dot11ExtStartOneX 只能在關聯後作業期間或作業完成之後呼叫。如需此作業的詳細資訊，請參閱關聯後作業。

呼叫 Dot11ExtStartOneX 函式時，操作系統會透過 LAN 傳送 EAP (EAPOL) Start 封包至 AP。如果 AP 在 EAPOL-Start 封包的三個傳輸之後無法回應，操作系統會失敗 802.1X 驗證作業並呼叫 Dot11ExtIhvOneXIndicateResult IHV 處理程式函式。如需有關 EAPOL-Start 封包的詳細資訊，請參閱 IEEE 802.1X-1999 標準的子句 7.5 和子句 8.4.2。

起始 802.1X 驗證作業之後，IHV 延伸模組 DLL 必須遵循這些指導方針。

IHV 延伸模組必須將所有EAPOL封包轉送到作業系統進行處理。當 DLL 透過對 Dot11ExtIhvReceivePacket IHV Handler 函式的呼叫收到 EAPOL 封包時，DLL 必須呼叫 Dot11ExtProcessOneXPacket ，以將封包轉送至操作系統。
如需 EAPOL 封包的詳細資訊，請參閱 IEEE 802.1X-2001 標準的第 7 句。

注意 IHV 延伸模組 DLL 負責處理 EAPOL-Key 封包，且不得將這些封包轉送到操作系統。
當 802.1X 驗證作業完成時，操作系統會呼叫 Dot11ExtIhvOneXIndicateResult IHV 處理程式函式，表示授權正在進行中。
IHV 延伸模組 DLL 可以藉由呼叫 Dot11ExtStopOneX 來取消 802.1X 驗證作業。

如需使用 802.1X 模組進行驗證的詳細資訊，請參閱原生 802.11 802.1X 模組的介面。

規格需求

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