DOT11EXT_ONEX_START función de devolución de llamada (wlanihv.h)

Artículo
08/08/2023

Importante La interfaz LAN inalámbrica nativa 802.11 está en desuso en Windows 10 y versiones posteriores. En su lugar, use la interfaz del controlador de dispositivos WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador universal de Windows WLAN.

El archivo DLL de extensiones de IHV llama a la función Dot11ExtStartOneX para iniciar una operación de autenticación 802.1X con el punto de acceso (AP). En esta situación, la autenticación se administra mediante el módulo 802.1X del marco Native 802.11 en lugar del archivo DLL de extensiones de IHV.

Sintaxis

DOT11EXT_ONEX_START Dot11extOnexStart;

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

Parámetros

[in, optional] hDot11SvcHandle

Identificador utilizado por el sistema operativo para hacer referencia al adaptador LAN inalámbrico (WLAN). Este valor de identificador se especificó a través de una llamada anterior a la función Dot11ExtIhvInitAdapter IHV Handler.

pEapAttributes

Valor devuelto

Si la llamada se realiza correctamente, la función devuelve ERROR_SUCCESS. De lo contrario, devuelve un código de error definido en Winerror.h.

Comentarios

El archivo DLL de extensiones de IHV puede iniciar una operación de autenticación 802.1X mediante el módulo 802.1X del marco Native 802.11. Esto permite que el archivo DLL use los algoritmos estándar del protocolo de autenticación extensible (EAP) compatibles con el sistema operativo.

El archivo DLL de extensiones de IHV inicia la operación de autenticación 802.1X llamando a la función Dot11ExtStartOneX . Dot11ExtStartOneX solo se puede llamar durante una operación posterior a la asociación o una vez completada la operación. Para obtener más información sobre esta operación, vea Operaciones posteriores a la asociación.

Cuando se llama a la función Dot11ExtStartOneX , el sistema operativo envía un paquete EAP a través de LAN (EAPOL) Start al AP. Si el AP no responde después de tres transmisiones del paquete de EAPOL-Start, el sistema operativo produce un error en la operación de autenticación 802.1X y llama al Dot11ExtIhvOneXIndicateResult Función de controlador de IHV. Para obtener más información sobre el paquete de EAPOL-Start, consulte la cláusula 7.5 y la cláusula 8.4.2 del estándar IEEE 802.1X-1999.

Una vez iniciada la operación de autenticación 802.1X, el archivo DLL de extensiones de IHV debe seguir estas instrucciones.

Las extensiones de IHV deben reenviar todos los paquetes EAPOL al sistema operativo para su procesamiento. Cuando el archivo DLL recibe un paquete EAPOL a través de una llamada a la función Dot11ExtIhvReceivePacket IHV Handler, el archivo DLL debe llamar a Dot11ExtProcessOneXPacket para reenviar el paquete al sistema operativo.
Para obtener más información sobre los paquetes EAPOL, consulte la cláusula 7 del estándar IEEE 802.1X-2001.

Nota El archivo DLL de extensiones de IHV es responsable del procesamiento de paquetes EAPOL-Key y no debe reenviarlos al sistema operativo.
Una vez completada la operación de autenticación 802.1X, el sistema operativo llama al Dot11ExtIhvOneXIndicateResult Función de controlador de IHV para indicar que la autorización está en curso.
El archivo DLL de extensiones de IHV puede cancelar la operación de autenticación 802.1X llamando a Dot11ExtStopOneX.

Para obtener más información sobre el uso del módulo 802.1X para la autenticación, vea Interfaz al módulo Nativo 802.11 802.1X.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	wlanihv.h (incluya Wlanihv.h)