DOT11EXT_ONEX_START funzione di callback (wlanihv.h)

Articolo
05/23/2024

Importante L'interfaccia LAN wireless native 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver WINDOWS universale WLAN.

La DLL delle estensioni IHV chiama la funzione Dot11ExtStartOneX per avviare un'operazione di autenticazione 802.1X con il punto di accesso (AP). In questo caso, l'autenticazione viene gestita dal modulo 802.1X del framework Nativo 802.11 anziché dalla DLL delle estensioni IHV.

Sintassi

DOT11EXT_ONEX_START Dot11extOnexStart;

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

Parametri

[in, optional] hDot11SvcHandle

Handle utilizzato dal sistema operativo per fare riferimento alla scheda LAN wireless (WLAN). Questo valore handle è stato specificato tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in, optional] pEapAttributes

Puntatore a una struttura di matrice EAP_ATTRIBUTES che contiene gli attributi EAP restituiti dalla sessione di autenticazione. Per altre informazioni sulle EAP_ATTRIBUTES, vedere la documentazione di Microsoft Windows SDK.

Valore restituito

Se la chiamata ha esito positivo, la funzione restituisce ERROR_SUCCESS. In caso contrario, restituisce un codice di errore definito in Winerror.h.

Commenti

La DLL delle estensioni IHV può avviare un'operazione di autenticazione 802.1X usando il modulo 802.1X del framework Nativo 802.11. In questo modo la DLL può usare gli algoritmi EAP (Extensible Authentication Protocol) standard supportati dal sistema operativo.

La DLL delle estensioni IHV avvia l'operazione di autenticazione 802.1X chiamando la funzione Dot11ExtStartOneX . Dot11ExtStartOneX può essere chiamato solo durante un'operazione post-associazione o dopo il completamento dell'operazione. Per altre informazioni su questa operazione, vedere Operazioni post-associazione.

Quando viene chiamata la funzione Dot11ExtStartOneX , il sistema operativo invia un pacchetto EAP tramite LAN (EAPOL) Start all'API. Se l'API non risponde dopo tre trasmissioni del pacchetto EAPOL-Start, il sistema operativo non riesce l'operazione di autenticazione 802.1X e chiama Dot11ExtIhvOneXIndicateResult Funzione gestore IHV. Per altre informazioni sul pacchetto EAPOL-Start, vedere la clausola 7.5 e la clausola 8.4.2 dello standard IEEE 802.1X-1999.

Dopo l'avvio dell'operazione di autenticazione 802.1X, la DLL delle estensioni IHV deve seguire queste linee guida.

Le estensioni IHV devono inoltrare tutti i pacchetti EAPOL al sistema operativo per l'elaborazione. Quando la DLL riceve un pacchetto EAPOL tramite una chiamata alla funzione Dot11ExtIhvReceivePacket IHV Handler, la DLL deve chiamare Dot11ExtProcessOneXPacket per inoltrare il pacchetto al sistema operativo.
Per altre informazioni sui pacchetti EAPOL, vedere la clausola 7 dello standard IEEE 802.1X-2001.

Nota La DLL delle estensioni IHV è responsabile dell'elaborazione di pacchetti EAPOL-Key e non deve inoltrarli al sistema operativo.
Al termine dell'operazione di autenticazione 802.1X, il sistema operativo chiama Dot11ExtIhvOneXIndicateResult Funzione del gestore IHV per indicare che l'autorizzazione è in corso.
La DLL delle estensioni IHV può annullare l'operazione di autenticazione 802.1X chiamando Dot11ExtStopOneX.

Per altre informazioni sull'uso del modulo 802.1X per l'autenticazione, vedere Interfaccia al modulo Native 802.11 802.1X.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	wlanihv.h (include Wlanihv.h)