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

Artículo
08/08/2023

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 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 IHV para hacer referencia al adaptador de LAN inalámbrica (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).

[in, optional] pIhvProfileParams

Puntero a 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 DOT11EXT_IHV_CONNECTIVITY_PROFILE estructura que contiene la configuración de conectividad del perfil de IHV.

[in] pIhvSecProfile

Puntero a 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 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 IHV no puede iniciar la operación de asociación previa, devuelve un código de error definido en Winerror.h.

Comentarios

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 se debe completar 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 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 previa a la asociación se puede iniciar correctamente.
- Un valor de error de L2_REASON_CODE_xxxx adecuado, si no se pudo iniciar la operación de asociación previa.
- 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), independientemente de si la operación de asociación previa se puede iniciar o no.

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