DOT11EXT_ONEX_START función de devolución de llamada (wlanihv.h)
DOT11EXT_ONEX_START Dot11extOnexStart;
DWORD Dot11extOnexStart(
[in, optional] HANDLE hDot11SvcHandle,
[in, optional] EAP_ATTRIBUTES *pEapAttributes
)
{...}
[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.
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.
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.
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) |