DOT11EXT_POST_ASSOCIATE_COMPLETION 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.

A DLL de Extensões IHV chama a função Dot11ExtPostAssociateCompletion para concluir de forma assíncrona uma operação pós-associação iniciada por meio de uma chamada para o função Dot11ExtIhvPerformPostAssociate Manipulador de IHV.

Sintaxe

DOT11EXT_POST_ASSOCIATE_COMPLETION Dot11extPostAssociateCompletion;

DWORD Dot11extPostAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hSecuritySessionID,
  [in, optional] PDOT11_MAC_ADDRESS pPeer,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

Parâmetros

[in, optional] hDot11SvcHandle

O identificador usado pelo sistema operacional 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] hSecuritySessionID

O identificador do identificador de sessão de segurança (ID) retornado por meio de uma chamada anterior para o função Dot11ExtIhvPerformPostAssociate Manipulador de IHV.

[in, optional] pPeer

O endereço MAC (controle de acesso de mídia) do AP (ponto de acesso) com o qual a DLL de Extensões IHV executou uma operação de segurança. Esse parâmetro é formatado como uma estrutura DOT11_MAC_ADDRESS.

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

Um valor que fornece informações adicionais para o status de conclusão da operação pós-associação. A DLL de Extensões IHV deve definir dwReasonCode como um valor L2_REASON_CODE_xxxx, que são definidos em L2cmn.h.

A DLL de Extensões IHV retorna o status de conclusão geral da operação pós-associação por meio do parâmetro dwWin32Error. Normalmente, a DLL de Extensões IHV define dwReasonCode para um valor dentro do intervalo de L2_REASON_CODE_IHV_BASE para (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).

[in] dwWin32Error

O status de conclusão da operação pós-associação, conforme definido por um código de erro no Winerror.h. Se a operação for concluída com êxito, a DLL de Extensões IHV deverá definir dwWin32Error para ERROR_SUCCESS.

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

A DLL de Extensões IHV chama a função Dot11ExtPostAssociateCompletion para fazer qualquer um dos seguintes procedimentos:

Concluir a operação pós-associação iniciada por uma chamada para o função Dot11ExtIhvPerformPostAssociate Manipulador de IHV.
Depois de concluir a operação pós-associação, indique uma alteração no estado da porta para a sessão de segurança referenciada pelo parâmetro hSecuritySessionID.
Por exemplo, se o estado de autorização da porta for alterado, a DLL de Extensões IHV poderá notificar o sistema operacional chamando Dot11ExtPostAssociateCompletion.

A DLL de Extensões IHV deve seguir essas diretrizes ao chamar a função do Dot11ExtPostAssociateCompletion.

Se a operação pós-associação for concluída com êxito, a DLL de Extensões IHV deverá definir dwReasonCode 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 DLL de Extensões IHV deve definir dwWin32Error para ERROR_SUCCESS.
Observação Se a DLL de Extensões IHV definir dwWin32Error para ERROR_SUCCESS, o sistema operacional assumirá que o estado da porta da sessão de segurança está em um estado autorizado. Depois que a porta estiver em um estado autorizado, o sistema operacional permitirá que todos os pacotes de dados sejam enviados por meio do adaptador WLAN.
Se a operação pós-associação for concluída com uma falha, a DLL de Extensões IHV não deverá definir dwReasonCode como L2_REASON_CODE_SUCCESS. Em vez disso, a DLL deve definir dwReasonCode 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 DLL de Extensões IHV não deve definir dwWin32Error como ERROR_SUCCESS. Em vez disso, a DLL deve definir dwWin32Error para um código de erro apropriado definido em Winerror.h.
Observação Se a DLL de Extensões IHV não definir dwWin32Error para ERROR_SUCCESS, o sistema operacional assumirá que o estado da porta da sessão de segurança está em um estado não autorizado. Depois que a porta estiver em um estado não autorizado, o sistema operacional permitirá que pacotes de segurança, incluindo pacotes enviados por meio da função Dot11ExtSendPacket extensões IHV, sejam enviados por meio do adaptador WLAN.
A DLL de Extensões IHV deve chamar Dot11ExtPostAssociateCompletion para cancelar todas as operações pós-associação pendentes sempre que as funções Dot11ExtIhvAdapterReset ou Dot11ExtIhvDeinitAdapter do Manipulador IHV forem chamadas. Nessa situação, a DLL deve definir o parâmetro dwStatus como ERROR_CANCELLED.

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)