Partilhar via


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

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.
 
O sistema operacional chama a função Dot11ExtIhvPerformPostAssociate para solicitar que a DLL de Extensões IHV inicie uma operação pós-associação com a rede BSS (conjunto de serviços básico).

Sintaxe

DOT11EXTIHV_PERFORM_POST_ASSOCIATE Dot11extihvPerformPostAssociate;

DWORD Dot11extihvPerformPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hSecuritySessionID,
  [in]           PDOT11_PORT_STATE pPortState,
  [in]           ULONG uDot11AssocParamsBytes,
  [in]           PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
)
{...}

Parâmetros

[in, optional] hIhvExtAdapter

O identificador usado pela DLL de Extensões IHV 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 da sessão de segurança. A DLL de Extensões IHV deve usar esse valor de identificador quando ele chama Dot11ExtPostAssociateCompletion para concluir assíncronamente a operação pós-associação.

[in] pPortState

Um ponteiro para uma estrutura de DOT11_PORT_STATE, que especifica o estado atual da porta da sessão de segurança.

[in] uDot11AssocParamsBytes

O comprimento, em bytes, dos dados referenciados por meio do parâmetro pDot11AssocParams.

[in] pDot11AssocParams

Um ponteiro para um DOT11_ASSOCIATION_COMPLETION_PARAMETERS estrutura, que especifica o resultado da operação de associação concluída pelo adaptador WLAN. O driver de miniporto Nativo 802.11, que gerencia o adaptador WLAN, inclui uma estrutura de DOT11_ASSOCIATION_COMPLETION_PARAMETERS quando torna uma mídia específica NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indicação.

Para obter mais informações sobre a operação de associação, consulte operações de associação.

Valor de retorno

Se a DLL da Extensão IHV puder iniciar a operação pós-associação, ela deverá concluir a operação de forma assíncrona. Nessa situação, a função retorna ERROR_SUCCESS.

Se a DLL de Extensões IHV não puder iniciar a operação pós-associação, ela retornará um código de erro definido em Winerror.h.

Observações

O sistema operacional chama a função Dot11ExtIhvPerformPostAssociate para iniciar uma operação pós-associação com a DLL de Extensões IHV. O sistema operacional inicia essa operação depois que o adaptador WLAN conclui uma operação de associação com um AP (ponto de acesso) em uma rede BSS (conjunto de serviços básico) de infraestrutura.

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.
 
Para obter mais informações sobre a operação de associação, consulte operações de associação.

A operação pós-associação deve ser concluída de forma assíncrona da chamada para Dot11ExtIhvPerformPostAssociate. Após a conclusão da operação pós-associação, a DLL deve chamar Dot11ExtPostAssociateCompletion.

Se a DLL de Extensões IHV puder iniciar a operação pós-associação, a função Dot11ExtIhvPerformPostAssociate deverá retornar ERROR_SUCCESS e concluir a operação de forma assíncrona.

Para obter mais informações sobre a operação pós-associação, consulte operações pós-associação.

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 (incluem Wlanihv.h, Windot11.h, L2cmn.h)

Consulte também

Dot11ExtPostAssociateCompletion

Dot11ExtIhvInitAdapter

DOT11_PORT_STATE

Dot11ExtIhvAdapterReset

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION