Compartilhar via

Diretrizes de operação de pré-associação

  • Artigo

 

A DLL de Extensões IHV deve seguir estas diretrizes ao executar a operação de pré-associação.

  • Quando a função Dot11ExtIhvPerformPreAssociate é chamada, a DLL de Extensões IHV deve fazer o seguinte:

    • Verifique as extensões IHV para o perfil de conectividade e segurança. Se os parâmetros de perfil forem inválidos, a função Dot11ExtIhvPerformPreAssociate retornará um código de erro apropriado, conforme definido em Winerror.h.
    • Crie e inicie um novo thread para a conclusão da operação de pré-associação. Como a operação de pré-associação deve ser concluída de forma assíncrona da chamada para Dot11ExtIhvPerformPreAssociate, a DLL de Extensões IHV deve chamar Dot11ExtPreAssociateCompletion desse thread após a conclusão da operação.
    • Retornar ERROR_SUCCESS da chamada de função. Neste ponto, o sistema operacional é notificado de que o perfil de rede é válido e que a operação de pré-associação está em andamento.

  • A DLL de Extensões IHV pode chamar a função Dot11ExtNicSpecificExtension para configurar o adaptador WLAN (LAN sem fio). Essa função pode ser chamada de dentro da chamada para Dot11ExtIhvPerformPreAssociate ou do thread que manipula a operação de pré-associação após o retorno de Dot11ExtIhvPerformPreAssociate .

  • As chamadas para Dot11ExtSetProfileCustomUserData, Dot11ExtGetProfileCustomUserData e Dot11ExtSetCurrentProfile não devem ser feitas de dentro da chamada para Dot11ExtIhvPerformPreAssociate. Essas funções só podem ser chamadas depois que Dot11ExtIhvPerformPreAssociate retornar ERROR_SUCCESS.

  • Depois que a DLL de Extensões IHV chama Dot11ExtPreAssociateCompletion para concluir a operação de pré-associação, o identificador da sessão de conexão não é mais válido. O sistema operacional passa esse identificador pelo parâmetro hConnectSession de Dot11ExtIhvPerformPreAssociate. A DLL não deve usar esse valor de identificador ao chamar funções de Extensibilidade IHV que declarem um parâmetro hConnectSession .

    Para obter mais informações sobre as funções de extensibilidade IHV, consulte Funções de extensibilidade IHV nativas 802.11.

  • Se a função Dot11ExtIhvAdapterReset for chamada, a DLL de Extensões IHV deverá cancelar a operação de pré-associação chamando Dot11ExtPreAssociateCompletion. Para obter mais informações sobre a operação de redefinição, consulte Redefinição do adaptador WLAN 802.11.

  • Se a função Dot11ExtIhvDeinitAdapter for chamada, a DLL de Extensões IHV deverá cancelar a operação de pré-associação internamente. No entanto, ele não deve chamar nenhuma das funções de Extensibilidade IHV que só podem ser chamadas após a inicialização do adaptador, incluindo Dot11ExtPreAssociateCompletion.