DOT11EXT_ONEX_START回呼函式 (wlanihv.h)

重要原生 802.11 無線區域網路介面在 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,
                 EAP_ATTRIBUTES *pEapAttributes
)
{...}

參數

[in, optional] hDot11SvcHandle

作業系統用來參考無線區域網路 (WLAN) 介面卡的控制碼。 這個控制碼值是透過 先前呼叫 Dot11ExtIhvInitAdapter IHV Handler 函式所指定。

pEapAttributes

傳回值

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

備註

IHV 延伸模組 DLL 可以使用 Native 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)

另請參閱

Dot11ExtPostAssociateCompletion

Dot11ExtIhvReceivePacket

Dot11ExtProcessOneXPacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult Dot11ExtIhvPerformPostAssociate

Dot11ExtStopOneX