DOT11EXTIHV_PERFORM_CAPABILITY_MATCH 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 sistema operativo llama a la función Dot11ExtIhvPerformCapabilityMatch para solicitar que el ARCHIVO DLL de extensiones de IHV determine si una red de conjunto de servicios básico detectado (BSS) coincide con las extensiones de perfil de seguridad y conectividad definidas por el IHV.

Sintaxis

DOT11EXTIHV_PERFORM_CAPABILITY_MATCH Dot11extihvPerformCapabilityMatch;

DWORD Dot11extihvPerformCapabilityMatch(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in, optional] 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 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] pIhvProfileParams

Puntero a DOT11EXT_IHV_PROFILE_PARAMS estructura. Esta estructura define los atributos de la red básica del conjunto de servicios (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 contiene la configuración de seguridad del perfil de IHV.

[in, optional] pConnectableBssid

Puntero a una estructura de DOT11_BSS_LIST , que contiene uno o varios marcos de baliza o de sondeo de 802.11 recibidos de una red BSS. Esta lista se deriva de los resultados de la última operación de examen realizada por el adaptador WLAN. Para obtener más información sobre la operación de examen, consulte Operaciones de examen nativas 802.11.

Nota Para Windows Vista, el archivo DLL de extensiones de IHV solo admite redes de conjunto de servicios básicos de infraestructura (BSS).

[out] pdwReasonCode

Puntero a un valor DWORD, que proporciona información adicional para el valor devuelto de la función Dot11ExtIhvPerformCapabilityMatch . 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 todas las entradas de la lista de fotogramas de baliza y de sondeo de 802.11 admiten los atributos de conectividad y seguridad definidos en los fragmentos de perfil, la función devuelve ERROR_SUCCESS. De lo contrario, devuelve un código de error definido en Winerror.h.

Comentarios

Una vez que el adaptador WLAN ha completado una operación de examen para detectar las redes BSS dentro del intervalo, el sistema operativo podría llamar a la función Dot11ExtIhvPerformCapabilityMatch para determinar si alguna de las redes BSS detectadas coincide con las extensiones de perfil de seguridad o conectividad definidas por el IHV.

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

  • Si el archivo DLL de extensiones de IHV encuentra al menos un marco IEEE 802.11 Beacon o Probe Response que coincida con los fragmentos de perfil, debe establecer * pdwReasonCode 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, la función Dot11ExtIhvPerformCapabilityMatch debe devolver ERROR_SUCCESS.
  • Si el archivo DLL de extensiones de IHV no encuentra un marco IEEE 802.11 Beacon o Probe Response que coincida con los fragmentos de perfil, no debe establecer *pdwReasonCode en L2_REASON_CODE_SUCCESS. En su lugar, el archivo DLL debe establecer * pdwReasonCode 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, la función Dot11ExtIhvPerformCapabilityMatch no debe devolver ERROR_SUCCESS.
Para obtener más información sobre el esquema XML native 802.11, consulte la documentación de Microsoft Windows SDK.

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

Consulte también

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_SECURITY_PROFILE

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_PROFILE_PARAMS