fonction de rappel DOT11EXT_PRE_ASSOCIATE_COMPLETION (wlanihv.h)

Article
02/07/2025

important l’interface Native 802.11 Wireless LAN est déconseillée dans Windows 10 et versions ultérieures. Utilisez à la place l’interface WDI (Device Driver Interface) DU RÉSEAU LOCAL. Pour plus d’informations sur WDI, consultez modèle de pilote Windows universel LOCAL.

La DLL extensions IHV appelle la fonction Dot11ExtPreAssociateCompletion pour terminer de manière asynchrone une opération de pré-association lancée par le biais d’un appel au Dot11ExtIhvPerformPreAssociate fonction gestionnaire IHV.

Syntaxe

DOT11EXT_PRE_ASSOCIATE_COMPLETION Dot11extPreAssociateCompletion;

DWORD Dot11extPreAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

Paramètres

[in, optional] hDot11SvcHandle

Handle utilisé par le système d’exploitation pour référencer l’adaptateur RÉSEAU local sans fil (WLAN). Cette valeur de handle a été spécifiée via un appel précédent à la fonction de gestionnaire IHV Dot11ExtIhvInitAdapter.

[in, optional] hConnectSession

Handle utilisé par le système d’exploitation pour référencer la session de connexion avec le réseau BSS (Basic Service Set). Cette valeur de handle a été spécifiée par le biais d’un appel précédent au Dot11ExtIhvPerformPreAssociate fonction gestionnaire IHV.

[in] dwReasonCode

Valeur qui fournit des informations supplémentaires pour l’état d’achèvement de l’opération de pré-association. La DLL des extensions IHV doit définir dwReasonCode sur une valeur L2_REASON_CODE_xxxx, qui sont définies dans L2cmn.h.

La DLL extensions IHV retourne l’état d’achèvement général de l’opération de pré-association via le paramètre dwWin32Error. En règle générale, la DLL des extensions IHV définit dwReasonCode à une valeur comprise entre L2_REASON_CODE_IHV_BASE et (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).

[in] dwWin32Error

État d’achèvement de l’opération de pré-association telle qu’elle est définie par un code d’erreur dans Winerror.h. Si l’opération se termine correctement, la DLL des extensions IHV doit définir dwWin32Error sur ERROR_SUCCESS.

Valeur de retour

Si l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, elle retourne un code d’erreur défini dans Winerror.h.

Remarques

La DLL des extensions IHV doit suivre ces instructions lors de l’appel de la fonction Dot11ExtPreAssociateCompletion.

Si l’opération de pré-association s’est terminée avec succès, la DLL des extensions IHV doit définir dwReasonCode l’une des opérations suivantes :
- L2_REASON_CODE_SUCCESS.
- Valeur définie par IHV dans la plage comprise entre L2_REASON_CODE_IHV_BASE et (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
Dans ce cas, la DLL des extensions IHV doit définir dwWin32Error sur ERROR_SUCCESS.
Si l’opération de pré-association s’est terminée avec un échec, la DLL d’extensions IHV ne doit pas définir dwReasonCode sur L2_REASON_CODE_SUCCESS. Au lieu de cela, la DLL doit définir dwReasonCode sur l’une des options suivantes :
- Valeur d’erreur appropriée L2_REASON_CODE_xxxx.
- Valeur définie par IHV dans la plage comprise entre L2_REASON_CODE_IHV_BASE et (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
Dans ce cas, la DLL des extensions IHV ne doit pas définir dwWin32Error sur ERROR_SUCCESS. Au lieu de cela, la DLL doit définir dwWin32Error sur un code d’erreur approprié défini dans Winerror.h
La DLL des extensions IHV doit appeler Dot11ExtPreAssociateCompletion pour annuler toutes les opérations de pré-association en attente chaque fois que les fonctions Dot11ExtIhvAdapterReset ou Dot11ExtIhvDeinitAdapter fonctions de gestionnaire IHV sont appelées. Dans ce cas, la DLL doit définir le paramètre dwWin32Error sur ERROR_CANCELLED.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible	Bureau
d’en-tête	wlanihv.h (include Wlanihv.h)

Voir aussi

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

fonctions de gestionnaire IHV natives 802.11

Dot11ExtIhvPerformPreAssociate

Partager via