DOT11EXT_PRE_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 Dot11ExtPreAssociateCompletion para concluir de forma assíncrona uma operação de pré-associação iniciada por meio de uma chamada para o função Dot11ExtIhvPerformPreAssociate manipulador IHV.

Sintaxe

DOT11EXT_PRE_ASSOCIATE_COMPLETION Dot11extPreAssociateCompletion;

DWORD Dot11extPreAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [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] hConnectSession

O identificador usado pelo sistema operacional para fazer referência à sessão de conexão com a rede BSS (conjunto de serviços) básico. Esse valor de identificador foi especificado por meio de uma chamada anterior para o função Dot11ExtIhvPerformPreAssociate manipulador IHV.

[in] dwReasonCode

Um valor que fornece informações adicionais para o status de conclusão da operação de pré-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 de pré-associação por meio do parâmetro dwWin32Error. Normalmente, a DLL de Extensões IHV define dwReasonCode para um valor no 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 de pré-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 deve seguir essas diretrizes ao chamar a função do Dot11ExtPreAssociateCompletion.

Se a operação de pré-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.
Se a operação de pré-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
A DLL de Extensões IHV deve chamar Dot11ExtPreAssociateCompletion para cancelar todas as operações de pré-associação pendentes sempre que as funções Dot11ExtIhvAdapterReset ou Dot11ExtIhvDeinitAdapter manipulador IHV forem chamadas. Nessa situação, a DLL deve definir o parâmetro dwWin32Error para 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)

Consulte também

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

funções nativas do manipulador IHV 802.11

Dot11ExtIhvPerformPreAssociate

Partilhar via