DOT11EXT_PROCESS_ONEX_PACKET funzione di callback (wlanihv.h)

Articolo
08/08/2023

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 Dot11ExtProcessOneXPacket per inoltrare i pacchetti EAP tramite LAN (EAPOL) al sistema operativo per l'elaborazione durante un'operazione di autenticazione 802.1X con il punto di accesso (AP).

Sintassi

DOT11EXT_PROCESS_ONEX_PACKET Dot11extProcessOnexPacket;

DWORD Dot11extProcessOnexPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwInPacketSize,
  [in]           LPVOID pvInPacket
)
{...}

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] dwInPacketSize

Lunghezza, in byte, dei dati del pacchetto all'interno del buffer a cui fa riferimento il parametro pvInPacket .

[in] pvInPacket

Pacchetto EAPOL ricevuto dall'API. Il parametro pvInPacket deve fare riferimento al pacchetto EAPOL a partire dal campo tipo di pacchetto nell'unità dati del protocollo EAPOL (PDU). Per altre informazioni sul campo Tipo di pacchetto EAPOL, vedere clausola 7.5.4 nello standard IEEE 802.1X-2001.

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

Quando chiama la funzione Dot11ExtStartOneX , la DLL delle estensioni IHV avvia 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.

Mentre l'operazione di autenticazione 802.1X è in sospeso, la DLL delle estensioni IHV inoltra i pacchetti EAP tramite LAN (EAPOL) al sistema operativo tramite una chiamata alla funzione Dot11ExtProcessOneXPacket . La DLL delle estensioni IHV riceve questi pacchetti tramite la funzione Dot11ExtIhvReceivePacket IHV Handler.

Nota La DLL delle estensioni IHV è responsabile dell'elaborazione di pacchetti EAPOL-Key e non deve inoltrarli al sistema operativo.

Per altre informazioni sui pacchetti EAPOL, vedere la clausola 7 dello standard IEEE 802.1X-2001.

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)

Vedi anche

Dot11ExtIhvReceivePacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult

Dot11ExtStartOneX

Dot11ExtStopOneX

Condividi tramite