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

Artigo
08/08/2023

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

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 Dot11ExtIhvPerformPostAssociate Função manipulador 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 fazer referência ao 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 do identificador de sessão de segurança (ID) retornado por meio de uma chamada anterior para o Dot11ExtIhvPerformPostAssociate Função manipulador IHV.

[in, optional] pPeer

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

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

[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 como 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 como ERROR_SUCCESS.

Retornar valor

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.

Comentários

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 Dot11ExtIhvPerformPostAssociate Função manipulador 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 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 como ERROR_SUCCESS.
Nota Se a DLL de Extensões IHV definir dwWin32Error como 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 como um código de erro apropriado definido em Winerror.h.
Nota Se a DLL de Extensões IHV não definir dwWin32Error como 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 Extensões IHV Dot11ExtSendPacket , 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 do Manipulador IHV Dot11ExtIhvDeinitAdapter forem chamadas. Nessa situação, a DLL deve definir o parâmetro dwStatus como ERROR_CANCELLED.

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)