Partager via

Instructions relatives aux opérations de pré-association

  • Article

 

La DLL des extensions IHV doit suivre ces instructions lors de l’exécution de l’opération de pré-association.

  • Lorsque la fonction Dot11ExtIhvPerformPreAssociate est appelée, la DLL des extensions IHV doit effectuer les opérations suivantes :

    • Vérifiez les extensions IHV pour le profil de connectivité et de sécurité. Si les paramètres de profil ne sont pas valides, la fonction Dot11ExtIhvPerformPreAssociate retourne un code d’erreur approprié tel que défini dans Winerror.h.
    • Créez et commencez un thread pour la fin de l’opération de pré-association. Étant donné que l’opération de pré-association doit être effectuée de manière asynchrone à partir de l’appel à Dot11ExtIhvPerformPreAssociate, la DLL des extensions IHV doit appeler Dot11ExtPreAssociateCompletion à partir de ce thread une fois l’opération terminée.
    • Retourne ERROR_SUCCESS à partir de l’appel de fonction. À ce stade, le système d’exploitation est averti que le profil réseau est valide et que l’opération de pré-association est en cours.

  • La DLL des extensions IHV peut appeler la fonction Dot11ExtNicSpecificExtension pour configurer l’adaptateur LAN sans fil (WLAN). Cette fonction peut être appelée à partir de l’appel à Dot11ExtIhvPerformPreAssociate ou à partir du thread qui gère l’opération de pré-association après que Dot11ExtIhvPerformPreAssociate retourne.

  • Les appels à Dot11ExtSetProfileCustomUserData, Dot11ExtGetProfileCustomUserData et Dot11ExtSetCurrentProfile ne doivent pas être effectués à partir de l’appel à Dot11ExtIhvPerformPreAssociate. Ces fonctions peuvent uniquement être appelées après que Dot11ExtIhvPerformPreAssociate retourne ERROR_SUCCESS.

  • Une fois que la DLL extensions IHV a appelé Dot11ExtPreAssociateCompletion pour terminer l’opération de pré-association, le handle de la session de connexion n’est plus valide. Le système d’exploitation transmet ce handle via le paramètre hConnectSession de Dot11ExtIhvPerformPreAssociate. La DLL ne doit pas utiliser cette valeur de handle lors de l’appel de fonctions d’extensibilité IHV qui déclarent un paramètre hConnectSession .

    Pour plus d’informations sur les fonctions d’extensibilité IHV, consultez Fonctions d’extensibilité IHV natives 802.11.

  • Si la fonction Dot11ExtIhvAdapterReset est appelée, la DLL des extensions IHV doit annuler l’opération de pré-association en appelant Dot11ExtPreAssociateCompletion. Pour plus d’informations sur l’opération de réinitialisation, consultez Réinitialisation de l’adaptateur WLAN 802.11.

  • Si la fonction Dot11ExtIhvDeinitAdapter est appelée, la DLL des extensions IHV doit annuler l’opération de pré-association en interne. Toutefois, elle ne doit appeler aucune des fonctions d’extensibilité IHV qui peuvent être appelées uniquement après l’initialisation de l’adaptateur, y compris Dot11ExtPreAssociateCompletion.