DOT11EXT_ONEX_START função de retorno de chamada (wlanihv.h)
Sintaxe
DOT11EXT_ONEX_START Dot11extOnexStart;
DWORD Dot11extOnexStart(
[in, optional] HANDLE hDot11SvcHandle,
[in, optional] EAP_ATTRIBUTES *pEapAttributes
)
{...}
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] pEapAttributes
Um ponteiro para uma estrutura de matriz EAP_ATTRIBUTES que contém os atributos EAP retornados pela sessão de autenticação. Para obter mais informações sobre EAP_ATTRIBUTES, consulte a documentação do SDK do Microsoft Windows.
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 pode iniciar uma operação de autenticação 802.1X usando o módulo 802.1X da estrutura Native 802.11. Isso permite que a DLL use os algoritmos EAP (protocolo de autenticação extensível) padrão compatíveis com o sistema operacional.
A DLL de Extensões IHV inicia a operação de autenticação 802.1X chamando a função Dot11ExtStartOneX . Dot11ExtStartOneX só pode ser chamado durante uma operação pós-associação ou após a conclusão da operação. Para obter mais informações sobre essa operação, consulte Operações pós-associação.
Quando a função Dot11ExtStartOneX é chamada, o sistema operacional envia um pacote EAP sobre LAN (EAPOL) Start para a AP. Se a AP não responder após três transmissões do pacote EAPOL-Start, o sistema operacional falhará na operação de autenticação 802.1X e chamará o Dot11ExtIhvOneXIndicateResult Função manipulador IHV. Para obter mais informações sobre o pacote EAPOL-Start, consulte a Cláusula 7.5 e a Cláusula 8.4.2 do padrão IEEE 802.1X-1999.
Depois que a operação de autenticação 802.1X for iniciada, a DLL de Extensões IHV deverá seguir estas diretrizes.
-
As Extensões IHV devem encaminhar todos os pacotes EAPOL para o sistema operacional para processamento. Quando a DLL recebe um pacote EAPOL por meio de uma chamada para a função Dot11ExtIhvReceivePacket IHV Handler, a DLL deve chamar Dot11ExtProcessOneXPacket para encaminhar o pacote para o sistema operacional.
Para obter mais informações sobre pacotes EAPOL, consulte a Cláusula 7 do padrão IEEE 802.1X-2001.
Nota A DLL de Extensões IHV é responsável pelo processamento EAPOL-Key pacotes e não deve encaminhá-los para o sistema operacional. - Quando a operação de autenticação 802.1X é concluída, o sistema operacional chama o Dot11ExtIhvOneXIndicateResult Função manipulador IHV para indicar que a autorização está em andamento.
- A DLL de Extensões IHV pode cancelar a operação de autenticação 802.1X chamando Dot11ExtStopOneX.
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) |