função de retorno de chamada DOT11EXTIHV_PERFORM_CAPABILITY_MATCH (wlanihv.h)

Artigo
02/27/2024

Importante A interface lan sem fio Native 802.11 foi preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte WLAN Modelo de driver Universal do Windows.

O sistema operacional chama a função Dot11ExtIhvPerformCapabilityMatch para solicitar que a DLL de Extensões IHV determine se uma rede BSS (conjunto de serviços básico) detectada corresponde às extensões de perfil de segurança e conectividade definidas pelo IHV.

Sintaxe

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

O identificador usado pela DLL de Extensões IHV para fazer referência ao adaptador WLAN (LAN sem fio). Esse valor de identificador foi especificado por meio de uma chamada anterior para a função Manipulador IHV Dot11ExtIhvInitAdapter .

[in, optional] pIhvProfileParams

Um ponteiro para um DOT11EXT_IHV_PROFILE_PARAMS estrutura. Essa estrutura define os atributos da rede BSS (conjunto de serviços básico) à qual as extensões de perfil serão aplicadas.

[in] pIhvConnProfile

Um ponteiro para um DOT11EXT_IHV_CONNECTIVITY_PROFILE estrutura que contém configurações de conectividade para o perfil IHV.

[in] pIhvSecProfile

Um ponteiro para um DOT11EXT_IHV_SECURITY_PROFILE estrutura que contém configurações de segurança para o perfil IHV.

[in, optional] pConnectableBssid

Um ponteiro para uma estrutura DOT11_BSS_LIST , que contém um ou mais quadros 802.11 Beacon ou Probe Response recebidos de uma rede BSS. Essa lista é derivada dos resultados da última operação de verificação executada pelo adaptador WLAN. Para obter mais informações sobre a operação de verificação, consulte Operações de verificação nativas 802.11.

Nota Para o Windows Vista, a DLL de Extensões IHV dá suporte apenas a redes BSS (conjunto de serviços básicos de infraestrutura).

[out] pdwReasonCode

Um ponteiro para um valor DWORD, que fornece informações adicionais para o valor retornado da função Dot11ExtIhvPerformCapabilityMatch . A DLL de Extensões IHV deve definir * pdwReasonCode como um valor L2_REASON_CODE_xxxx, que são definidos em L2cmn.h.

Retornar valor

Se todas as entradas na lista de quadros 802.11 Beacon e Probe Response derem suporte aos atributos de conectividade e segurança definidos nos fragmentos de perfil, a função retornará ERROR_SUCCESS. Caso contrário, ele retornará um código de erro definido em Winerror.h.

Comentários

Depois que o adaptador WLAN concluir uma operação de verificação para detectar as redes BSS dentro do intervalo, o sistema operacional poderá chamar a função Dot11ExtIhvPerformCapabilityMatch para determinar se alguma das redes BSS detectadas corresponde às extensões de conectividade ou perfil de segurança definidas pelo IHV.

Quando a função Dot11ExtIhvPerformCapabilityMatch é chamada, a DLL de Extensões IHV deve seguir essas diretrizes.

Se a DLL de Extensões IHV encontrar pelo menos um quadro de Beacon ou Resposta de Investigação do IEEE 802.11 que corresponda aos fragmentos de perfil, ele deverá definir * pdwReasonCode como um dos seguintes:
- L2_REASON_CODE_SUCCESS.
- Um valor definido por IHV no intervalo de L2_REASON_CODE_IHV_BASE a (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
Nessa situação, a função Dot11ExtIhvPerformCapabilityMatch deve retornar ERROR_SUCCESS.
Se a DLL de Extensões IHV não encontrar um sinalizador IEEE 802.11 ou um quadro de resposta de investigação que corresponda aos fragmentos de perfil, ele não deverá definir *pdwReasonCode como L2_REASON_CODE_SUCCESS. Em vez disso, a DLL deve definir * pdwReasonCode como um dos seguintes:
- Um valor de erro de L2_REASON_CODE_xxxx apropriado.
- Um valor definido por IHV no intervalo de L2_REASON_CODE_IHV_BASE a (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
Nessa situação, a função Dot11ExtIhvPerformCapabilityMatch não deve retornar ERROR_SUCCESS.

Para obter mais informações sobre o esquema XML do Native 802.11, consulte a documentação do SDK do Microsoft Windows.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	wlanihv.h (inclua Wlanihv.h, Winclient.h, L2cmn.h)