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

2025-02-07

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 sistema operativo llama a la función dot11ExtIhvPerformPreAssociate para solicitar que el archivo DLL de extensiones de IHV inicie una operación de asociación previa con la red básica del conjunto de servicios (BSS).

Sintaxis

DOT11EXTIHV_PERFORM_PRE_ASSOCIATE Dot11extihvPerformPreAssociate;

DWORD Dot11extihvPerformPreAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in]           PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDWORD pdwReasonCode
)
{...}

Parámetros

[in, optional] hIhvExtAdapter

Identificador utilizado por el archivo DLL de extensiones de IHV 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 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).

[in, optional] pIhvProfileParams

Puntero a un DOT11EXT_IHV_PROFILE_PARAMS estructura. Esta estructura define los atributos de la red del conjunto de servicios básico (BSS) a la que se aplicarán las extensiones de perfil.

[in] pIhvConnProfile

Puntero a un DOT11EXT_IHV_CONNECTIVITY_PROFILE estructura que contiene la configuración de conectividad del perfil de IHV.

[in] pIhvSecProfile

Puntero a un DOT11EXT_IHV_SECURITY_PROFILE estructura que especifica la configuración de seguridad del perfil de IHV.

[in] pConnectableBssid

Puntero a una estructura de DOT11_BSS_LIST, que contiene uno o varios marcos de baliza o respuesta de sondeo 802.11 para el identificador del conjunto de servicios (SSID) de la red BSS con la que el archivo DLL realizará la operación de asociación previa.

[out] pdwReasonCode

Puntero a un valor DWORD, que proporciona información adicional para el valor devuelto de la función Dot11ExtIhvPerformPreAssociate. El archivo DLL de extensiones de IHV debe establecer * pdwReasonCode en un valor de L2_REASON_CODE_xxxx, que se definen en L2cmn.h.

Valor devuelto

Si el archivo DLL de extensión IHV puede iniciar la operación de asociación previa, debe completar la operación de forma asincrónica. En esta situación, la función devuelve ERROR_SUCCESS.

Si el archivo DLL de extensiones de IHV no puede iniciar la operación de asociación previa, devuelve un código de error definido en Winerror.h.

Observaciones

El sistema operativo llama a la función Dot11ExtIhvPerformPreAssociate para iniciar una operación de asociación previa con el archivo DLL de extensiones de IHV. El sistema operativo inicia esta operación antes de iniciar una operación de conexión con una red básica de conjunto de servicios (BSS) a través del adaptador WLAN. Para obtener más información sobre la operación de conexión, consulte Operaciones de conexión.

La operación de asociación previa debe completarse de forma asincrónica desde la llamada a Dot11ExtIhvPerformPreAssociate. Una vez completada la operación de asociación previa, el archivo DLL de extensiones de IHV debe llamar a Dot11ExtPreAssociateCompletion.

Cuando se llama a la función Dot11ExtIhvPerformPreAssociate, el archivo DLL de extensiones de IHV debe seguir estas instrucciones.

Si el archivo DLL de extensiones de IHV puede iniciar la operación de asociación previa, la función Dot11ExtIhvPerformPreAssociate debe devolver ERROR_SUCCESS y completar la operación de forma asincrónica.
El archivo DLL de extensiones de IHV proporciona más información sobre el inicio de la operación de asociación previa a través del parámetro pdwReasonCode. El archivo DLL debe establecer * pdwReasonCode en uno de los siguientes elementos:
- L2_REASON_CODE_SUCCESS, si la operación de asociación previa se puede iniciar correctamente.
- Un valor de error L2_REASON_CODE_xxxx adecuado, si no se pudo iniciar la operación de asociación previa.
- Valor definido por IHV en el intervalo entre L2_REASON_CODE_IHV_BASE y (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1), independientemente de si se puede iniciar o no la operación de asociación previa.

Para obtener más información sobre la operación previa a la asociación, vea Operación previa a la asociación.

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 (include Wlanihv.h, L2cmn.h)