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

Artículo
02/07/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 Dot11ExtPostAssociateCompletion para completar de forma asincrónica una operación posterior a la asociación iniciada a través de una llamada a la función Dot11ExtIhvPerformPostAssociate IHV Handler.

Sintaxis

DOT11EXT_POST_ASSOCIATE_COMPLETION Dot11extPostAssociateCompletion;

DWORD Dot11extPostAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hSecuritySessionID,
  [in, optional] PDOT11_MAC_ADDRESS pPeer,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

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

Identificador de sesión de seguridad (ID) devuelto a través de una llamada anterior a . función Dot11ExtIhvPerformPostAssociate IHV Handler.

[in, optional] pPeer

Dirección del control de acceso multimedia (MAC) del punto de acceso (AP) con el que el archivo DLL de extensiones de IHV realizó una operación de seguridad. Este parámetro tiene el formato de estructura DOT11_MAC_ADDRESS.

Nota Para Windows Vista, el archivo DLL de extensiones de IHV solo admite redes de conjunto de servicios básicos de infraestructura (BSS).

[in] dwReasonCode

Valor que proporciona información adicional para el estado de finalización de la operación posterior a la asociación. El archivo DLL de extensiones de IHV debe establecer dwReasonCode en un valor de L2_REASON_CODE_xxxx, que se definen en L2cmn.h.

El archivo DLL de extensiones de IHV devuelve el estado de finalización general de la operación posterior a la asociación a través del parámetro dwWin32Error. Normalmente, el archivo DLL de extensiones de IHV establece dwReasonCode en un valor dentro del intervalo de L2_REASON_CODE_IHV_BASE a (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).

[in] dwWin32Error

Estado de finalización de la operación posterior a la asociación tal como se define mediante un código de error dentro de Winerror.h. Si la operación se completa correctamente, el archivo DLL de extensiones de IHV debe establecer dwWin32Error en ERROR_SUCCESS.

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 llama a la función Dot11ExtPostAssociateCompletion para realizar cualquiera de las siguientes acciones:

Complete la operación posterior a la asociación iniciada por una llamada a función Dot11ExtIhvPerformPostAssociate IHV Handler.
Después de completar la operación posterior a la asociación, indique un cambio en el estado del puerto para la sesión de seguridad a la que hace referencia el parámetro hSecuritySessionID.
Por ejemplo, si cambia el estado de autorización del puerto, el archivo DLL de extensiones de IHV puede notificar al sistema operativo llamando a Dot11ExtPostAssociateCompletion.

El archivo DLL de extensiones de IHV debe seguir estas instrucciones al llamar a la función Dot11ExtPostAssociateCompletion.

Si la operación posterior a la asociación se completó correctamente, la DLL de extensiones de IHV debe establecer dwReasonCode en una de las siguientes opciones:
- L2_REASON_CODE_SUCCESS.
- Valor definido por IHV en el intervalo de L2_REASON_CODE_IHV_BASE a (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
En esta situación, el archivo DLL de extensiones de IHV debe establecer dwWin32Error en ERROR_SUCCESS.
Nota Si el archivo DLL de extensiones de IHV establece dwWin32Error en ERROR_SUCCESS, el sistema operativo asume que el estado del puerto de la sesión de seguridad está en estado autorizado. Una vez que el puerto está en un estado autorizado, el sistema operativo permite que todos los paquetes de datos se envíen a través del adaptador WLAN.
Si la operación posterior a la asociación se completó con un error, el archivo DLL de extensiones de IHV no debe establecer dwReasonCode en L2_REASON_CODE_SUCCESS. En su lugar, el archivo DLL debe establecer dwReasonCode en una de las siguientes opciones:
- Valor de error L2_REASON_CODE_xxxx adecuado.
- Valor definido por IHV en el intervalo de L2_REASON_CODE_IHV_BASE a (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
En esta situación, el archivo DLL de extensiones de IHV no debe establecer dwWin32Error en ERROR_SUCCESS. En su lugar, el archivo DLL debe establecer dwWin32Error en un código de error adecuado definido en Winerror.h.
Nota Si el archivo DLL de extensiones de IHV no establece dwWin32Error en ERROR_SUCCESS, el sistema operativo asume que el estado del puerto de la sesión de seguridad está en un estado no autorizado. Una vez que el puerto está en un estado no autorizado, el sistema operativo permite que los paquetes de seguridad, incluidos los paquetes enviados a través del Dot11ExtSendPacket función IHV Extensions, se envíen a través del adaptador WLAN.
El archivo DLL de extensiones de IHV debe llamar a dot11ExtPostAssociateCompletion para cancelar todas las operaciones de asociación posteriores pendientes siempre que se llame a la Dot11ExtIhvAdapterReset o Dot11ExtIhvDeinitAdapter funciones de controlador de IHV. En esta situación, el archivo DLL debe establecer el parámetro dwStatus en ERROR_CANCELLED.

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)