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

Artículo
03/05/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 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 . Dot11ExtIhvPerformPostAssociate Función 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 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] hSecuritySessionID

Identificador de la sesión de seguridad (ID) devuelto a través de una llamada anterior a . Dot11ExtIhvPerformPostAssociate Función 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 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 y como se define mediante un código de error en 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.

Comentarios

El archivo DLL de extensiones de IHV llama a la función Dot11ExtPostAssociateCompletion para realizar cualquiera de las acciones siguientes:

Complete la operación posterior a la asociación iniciada por una llamada a . Dot11ExtIhvPerformPostAssociate Función IHV Handler.
Después de completar la operación posterior a la asociación, indique un cambio en el estado del puerto de 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, el archivo DLL de extensiones de IHV debe establecer dwReasonCode en uno de los siguientes elementos:
- 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 un 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 de 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 de la función Dot11ExtSendPacket IHV Extensions, se envíen a través del adaptador WLAN.
El archivo DLL de extensiones IHV debe llamar a Dot11ExtPostAssociateCompletion para cancelar todas las operaciones posteriores a la asociación pendientes siempre que se llame a las funciones Dot11ExtIhvAdapterReset o Dot11ExtIhvDeinitAdapter IHV Handler. En esta situación, el archivo DLL debe establecer el parámetro dwStatus en ERROR_CANCELLED.

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)