DOT11EXTIHV_PERFORM_CAPABILITY_MATCH função de retorno de chamada (wlanihv.h)
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 referenciar o adaptador WLAN (LAN sem fio). Esse valor de identificador foi especificado por meio de uma chamada anterior para a função Dot11ExtIhvInitAdapter manipulador IHV.
[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 ao 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 de DOT11_BSS_LIST, que contém um ou mais quadros de 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.
[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 para um valor de L2_REASON_CODE_xxxx, que são definidos em L2cmn.h.
Valor de retorno
Se todas as entradas na lista de quadros 802.11 Beacon e Probe Response deem 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.
Observações
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 perfil de segurança ou conectividade definidas pelo IHV.
Quando a função Dot11ExtIhvPerformCapabilityMatch for chamada, a DLL de Extensões IHV deverá seguir essas diretrizes.
-
Se a DLL de Extensões IHV encontrar pelo menos um quadro de resposta de investigação ou sinalizador IEEE 802.11 que corresponda aos fragmentos de perfil, ele deverá definir * pdwReasonCode para 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).
-
Se a DLL de Extensões IHV não encontrar um quadro de resposta de investigação ou sinalizador IEEE 802.11 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 para 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).
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wlanihv.h (incluem Wlanihv.h, Winclient.h, L2cmn.h) |