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

Artículo
05/23/2024

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 dispositivo WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador de Windows universal WLAN.

El archivo DLL de extensiones 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 de mediante el archivo DLL de extensiones de IHV.

Sintaxis

DOT11EXT_ONEX_START Dot11extOnexStart;

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

Parámetros

[in, optional] hDot11SvcHandle

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

[in, optional] pEapAttributes

Puntero a una estructura de matriz EAP_ATTRIBUTES que contiene los atributos EAP devueltos por la sesión de autenticación. Para obtener más información sobre EAP_ATTRIBUTES, consulte la documentación de Microsoft Windows SDK.

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 mediante una llamada a la función Dot11ExtStartOneX . Solo se puede llamar a Dot11ExtStartOneX durante una operación posterior a la asociación o después de que se haya completado 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 sobre LAN (EAPOL) Start al AP. Si el AP no responde después de tres transmisiones del paquete EAPOL-Start, el sistema operativo produce un error en la operación de autenticación 802.1X y llama al Dot11ExtIhvOneXIndicateResult Función IHV Handler. 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 IHV debe seguir estas instrucciones.

Las extensiones 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 IHV es responsable del procesamiento de paquetes EAPOL-Key y no debe reenviar estos al sistema operativo.
Cuando se completa la operación de autenticación 802.1X, el sistema operativo llama a Dot11ExtIhvOneXIndicateResult Función de controlador de IHV para indicar que la autorización está en curso.
El archivo DLL de extensiones 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, consulte Interface to the Native 802.11 802.1X Module.

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 (incluye Wlanihv.h)