DOT11EXTIHV_STOP_POST_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 Dot11ExtIhvStopPostAssociate para cancelar a operação pós-associação iniciada por meio de uma chamada para o função Dot11ExtIhvPerformPostAssociate Manipulador de IHV.

Sintaxe

DOT11EXTIHV_STOP_POST_ASSOCIATE Dot11extihvStopPostAssociate;

DWORD Dot11extihvStopPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           PDOT11_MAC_ADDRESS pPeer,
  [in]           DOT11_ASSOC_STATUS dot11AssocStatus
)
{...}

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

Um ponteiro para uma estrutura de DOT11_MAC_ADDRESS, que contém o MAC (controle de acesso de mídia) do ponto de acesso (AP) com o qual a DLL de Extensões IHV iniciou uma operação pós-associação.

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

[in] dot11AssocStatus

Um tipo de DOT11_ASSOC_STATUS que especifica o status de associação da estação 802.11 para a rede.

Valor de retorno

Se a chamada for bem-sucedida, a função retornará ERROR_SUCCESS. Caso contrário, ele retornará um código de erro definido em Winerror.h.

Observações

O sistema operacional chama a função Dot11ExtIhvStopPostAssociate para cancelar a operação pós-associação sempre que ocorrer um destes procedimentos.

O adaptador WLAN conclui uma operação de desassociação com a AP. Nessa situação, o driver de miniporto Native 802.11, que gerencia o adaptador, torna uma mídia específica NDIS_STATUS_DOT11_DISASSOCIATION indicação. Para obter mais informações sobre a operação de desassociação, consulte Operações de Desassociação.
O adaptador WLAN está desabilitado ou removido. Nessa situação, o sistema operacional chama a função Dot11ExtIhvStopPostAssociate antes de chamar o função Dot11ExtIhvDeinitAdapter.

O sistema operacional chama a função Dot11ExtIhvStopPostAssociate para notificar a DLL de Extensões IHV de que a porta de dados criada para a associação está inativa. O sistema operacional chama essa função independentemente de a DLL ter concluído a operação pós-associação por meio de uma chamada para Dot11ExtPostAssociateCompletion.

Para obter mais informações sobre a operação pós-associação, consulte operações pós-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, Windot11.h)

Consulte também

DOT11_ASSOC_STATUS

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

NDIS_STATUS_DOT11_DISASSOCIATION Dot11ExtIhvPerformPostAssociate

DOT11_MAC_ADDRESS

Partilhar via