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

Artículo
07/02/2025

importante la interfaz Native 802.11 Wireless LAN está en desuso en Windows 10 y versiones posteriores. Use la interfaz de controlador de dispositivo WLAN (WDI) en su lugar. Para obtener más información sobre WDI, consulta modelo de controlador de Windows universal 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 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 LAN inalámbrico (WLAN). Este valor de identificador se especificó a través de una llamada anterior a la función de controlador de IHV Dot11ExtIhvInitAdapt er.

[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 del SDK de Microsoft Windows.

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.

Observaciones

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 de. 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, consulte 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 función Dot11ExtIhvOneXIndicateResult 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 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 al Dot11ExtIhvReceivePacket función de controlador de IHV, 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 La DLL de extensiones de IHV es responsable del procesamiento de paquetes EAPOL-Key y no debe reenviar estos al sistema operativo.
Una vez completada la operación de autenticación 802.1X, el sistema operativo llama a función Dot11ExtIhvOneXIndicateResult 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 Interface to the Native 802.11 802.1X Module.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
de la plataforma de destino de	Escritorio
encabezado de	wlanihv.h (incluya Wlanihv.h)