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

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 .

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

• 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

Confira também

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

Funções nativas do manipulador IHV 802.11

DOT11_MAC_ADDRESS

Dot11ExtSendPacket