Partager via


Instructions relatives aux opérations de pré-association

 

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 d’extensions IHV doit effectuer les opérations suivantes :

    • Vérifiez les extensions IHV pour la connectivité et le profil 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 nouveau thread pour l’achèvement 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 d’extensions IHV doit appeler Dot11ExtPreAssociateCompletion à partir de ce thread une fois l’opération terminée.
    • Retournez 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 le retour de Dot11ExtIhvPerformPreAssociate.

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

  • Une fois que la DLL des extensions IHV appelle 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 Les fonctions d’extensibilité IHV natives 802.11.

  • Si la fonction Dot11ExtIhvAdapterReset est appelée, la DLL d’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 d’extensions IHV doit annuler l’opération de pré-association en interne. Toutefois, il ne doit appeler aucune des fonctions d’extensibilité IHV qui ne peuvent être appelées qu’après l’initialisation de l’adaptateur, y compris Dot11ExtPreAssociateCompletion.