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

Artigo
02/07/2025

Importante A interface de lan sem fio do Nativo 802.11 é preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte do modelo de driver Universal do Windows da WLAN.

O sistema operacional chama a função Dot11ExtIhvPerformPreAssociate para solicitar que a DLL de Extensões IHV inicie uma operação de pré-associação com a rede BSS (conjunto de serviços básico).

Sintaxe

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

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] hConnectSession

O identificador usado pelo sistema operacional para fazer referência à sessão de conexão com a rede BSS (conjunto de serviços) básico.

[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 especifica as configurações de segurança para o perfil IHV.

[in] pConnectableBssid

Um ponteiro para uma estrutura DOT11_BSS_LIST, que contém um ou mais quadros 802.11 Beacon ou Probe Response para o SSID (identificador do conjunto de serviços) da rede BSS com a qual a DLL executará a operação de pré-associação.

[out] pdwReasonCode

Um ponteiro para um valor DWORD, que fornece informações adicionais para o valor retornado da função Dot11ExtIhvPerformPreAssociate. 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 a DLL da Extensão IHV puder iniciar a operação de pré-associação, ela deverá concluir a operação de forma assíncrona. Nessa situação, a função retorna ERROR_SUCCESS.

Se a DLL de Extensões IHV não puder iniciar a operação de pré-associação, ela retornará um código de erro definido em Winerror.h.

Observações

O sistema operacional chama a função Dot11ExtIhvPerformPreAssociate para iniciar uma operação de pré-associação com a DLL de Extensões IHV. O sistema operacional inicia essa operação antes de iniciar uma operação de conexão com uma rede BSS (conjunto de serviços) básico por meio do adaptador WLAN. Para obter mais informações sobre a operação de conexão, consulte Operações de Conexão.

A operação de pré-associação deve ser concluída de forma assíncrona da chamada para Dot11ExtIhvPerformPreAssociate. Após a conclusão da operação de pré-associação, a DLL de Extensões IHV deve chamar Dot11ExtPreAssociateCompletion.

Quando a função Dot11ExtIhvPerformPreAssociate for chamada, a DLL de Extensões IHV deverá seguir essas diretrizes.

Se a DLL de Extensões IHV puder iniciar a operação de pré-associação, a função Dot11ExtIhvPerformPreAssociate deverá retornar ERROR_SUCCESS e concluir a operação de forma assíncrona.
A DLL de Extensões IHV fornece mais informações sobre a iniciação da operação de pré-associação por meio do parâmetro pdwReasonCode. A DLL deve definir * pdwReasonCode para um dos seguintes:
- L2_REASON_CODE_SUCCESS, se a operação de pré-associação puder ser iniciada com êxito.
- Um valor de erro de L2_REASON_CODE_xxxx apropriado, se a operação de pré-associação não puder ser iniciada.
- 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), independentemente de a operação de pré-associação ser iniciada ou não.

Para obter mais informações sobre a operação de pré-associação, consulte operação de pré-associação.

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