Compartir a través de

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

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 Dot11ExtPreAssociateCompletion para completar de forma asincrónica una operación de asociación previa iniciada a través de una llamada a la función Dot11ExtIhvPerformPreAssociate IHV Handler.

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 de controlador de IHV Dot11ExtIhvInitAdapt er.

[in, optional] hConnectSession

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

[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 entre L2_REASON_CODE_IHV_BASE y (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.

Observaciones

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, 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.
  • 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 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
  • 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 de Dot11ExtIhvAdapterReset o Dot11ExtIhvDeinitAdapter funciones de controlador de IHV. En esta situación, el archivo DLL debe establecer el parámetro dwWin32Error 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)

Consulte también

dot11ExtIhvAdapterReset

dot11ExtIhvDeinitAdapter

dot11ExtIhvInitAdapter

funciones de controlador IHV nativas 802.11

Dot11ExtIhvPerformPreAssociate