Compartir a través de

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

  • Artículo
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 dispositivos WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador universal de Windows WLAN.
 
El archivo DLL de extensiones de IHV llama a la función Dot11ExtPreAssociateCompletion para completar de forma asincrónica una operación de asociación previa iniciada a través de una llamada a . Dot11ExtIhvPerformPreAssociate Función de controlador de IHV.

Sintaxis

DOT11EXT_PRE_ASSOCIATE_COMPLETION Dot11extPreAssociateCompletion;

DWORD Dot11extPreAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [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 Dot11ExtIhvInitAdapter IHV Handler.

[in, optional] hConnectSession

Identificador utilizado por el sistema operativo para hacer referencia a la sesión de conexión con la red básica del conjunto de servicios (BSS). Este valor de identificador se especificó a través de una llamada anterior a . Dot11ExtIhvPerformPreAssociate Función de controlador de IHV.

[in] dwReasonCode

Valor que proporciona información adicional para el estado de finalización de la operación de asociación previa. 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 de asociación previa a través del parámetro dwWin32Error . Normalmente, el archivo DLL de extensiones de IHV establece dwReasonCode en un valor 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 de asociación previa tal como se define en 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.

Comentarios

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

  • Si la operación de asociación previa 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.
  • Si la operación de asociación previa 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 uno de los siguientes elementos:
    • 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.
  • El archivo DLL de extensiones de IHV debe llamar a Dot11ExtPreAssociateCompletion para cancelar todas las operaciones de asociación previa 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 dwWin32Error 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 (incluya Wlanihv.h)

Consulte también

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

Funciones de controlador IHV nativas 802.11

Dot11ExtIhvPerformPreAssociate