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

Artigo
08/08/2023

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

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

Sintaxe

DOT11EXTIHV_PERFORM_POST_ASSOCIATE Dot11extihvPerformPostAssociate;

DWORD Dot11extihvPerformPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hSecuritySessionID,
  [in]           PDOT11_PORT_STATE pPortState,
  [in]           ULONG uDot11AssocParamsBytes,
  [in]           PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
)
{...}

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 manipulador IHV Dot11ExtIhvInitAdapter .

[in, optional] hSecuritySessionID

O identificador da sessão de segurança. A DLL de Extensões IHV deve usar esse valor de identificador ao chamar Dot11ExtPostAssociateCompletion para concluir de forma assíncrona a operação pós-associação.

[in] pPortState

Um ponteiro para uma estrutura DOT11_PORT_STATE , que especifica o estado da porta atual da sessão de segurança.

[in] uDot11AssocParamsBytes

O comprimento, em bytes, dos dados referenciados por meio do parâmetro pDot11AssocParams .

[in] pDot11AssocParams

Um ponteiro para um DOT11_ASSOCIATION_COMPLETION_PARAMETERS estrutura, que especifica o resultado da operação de associação concluída pelo adaptador WLAN. O driver de miniporto Native 802.11, que gerencia o adaptador WLAN, inclui uma estrutura de DOT11_ASSOCIATION_COMPLETION_PARAMETERS quando torna uma mídia específica NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indicação.

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

Retornar valor

Se a DLL da extensão IHV puder iniciar a operação pós-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 pós-associação, ela retornará um código de erro definido em Winerror.h.

Comentários

O sistema operacional chama a função Dot11ExtIhvPerformPostAssociate para iniciar uma operação pós-associação com a DLL de Extensões IHV. O sistema operacional inicia essa operação depois que o adaptador WLAN conclui uma operação de associação com um AP (ponto de acesso) em uma rede BSS (conjunto de serviços básicos) de infraestrutura.

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.

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

A operação pós-associação deve ser concluída de forma assíncrona da chamada para Dot11ExtIhvPerformPostAssociate. Após a conclusão da operação pós-associação, a DLL deve chamar Dot11ExtPostAssociateCompletion.

Se a DLL de Extensões IHV puder iniciar a operação pós-associação, a função Dot11ExtIhvPerformPostAssociate deverá retornar ERROR_SUCCESS e concluir a operação de forma assíncrona.

Para obter mais informações sobre a operação pós-associação, consulte Operações pós-associação.

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