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

Artigo
08/08/2023

Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte 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 Dot11ExtIhvPerformPreAssociate Função 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 manipulador IHV Dot11ExtIhvInitAdapter .

[in, optional] hConnectSession

O identificador usado pelo sistema operacional para referenciar a 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 Dot11ExtIhvPerformPreAssociate Função 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 a 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 como um valor no intervalo de L2_REASON_CODE_IHV_BASE a (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).

[in] dwWin32Error

A conclusão status 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 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 deve seguir estas diretrizes ao chamar a função 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 como 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 como 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 IHV Handler forem chamadas. Nessa situação, a DLL deve definir o parâmetro dwWin32Error 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)