fonction de rappel DOT11EXT_POST_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 Dot11ExtPostAssociateCompletion pour terminer de façon asynchrone une opération post-association lancée par le biais d’un appel à la Dot11ExtIhvPerformPostAssociate fonction gestionnaire IHV.

Syntaxe

DOT11EXT_POST_ASSOCIATE_COMPLETION Dot11extPostAssociateCompletion;

DWORD Dot11extPostAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hSecuritySessionID,
  [in, optional] PDOT11_MAC_ADDRESS pPeer,
  [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] hSecuritySessionID

Handle de l’identificateur de session de sécurité retourné par le biais d’un appel précédent au Dot11ExtIhvPerformPostAssociate fonction gestionnaire IHV.

[in, optional] pPeer

Adresse MAC (Media Access Control) du point d’accès (AP) avec lequel la DLL d’extensions IHV a effectué une opération de sécurité. Ce paramètre est mis en forme en tant que structure DOT11_MAC_ADDRESS.

Remarque pour Windows Vista, la DLL d’extensions IHV prend uniquement en charge les réseaux BSS (Infrastructure Basic Service Set).

[in] dwReasonCode

Valeur qui fournit des informations supplémentaires pour l’état d’achèvement de l’opération post-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 post-association via le paramètre dwWin32Error. En règle générale, la DLL des extensions IHV définit dwReasonCode sur 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 post-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 appelle la fonction Dot11ExtPostAssociateCompletion pour effectuer l’une des opérations suivantes :

Effectuer l’opération post-association lancée par un appel au Dot11ExtIhvPerformPostAssociate fonction gestionnaire IHV.
Une fois l’opération post-association terminée, indiquez une modification de l’état du port de la session de sécurité référencée par le paramètre hSecuritySessionID.
Par exemple, si l’état d’autorisation du port change, la DLL des extensions IHV peut notifier le système d’exploitation en appelant Dot11ExtPostAssociateCompletion.

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

Si l’opération post-association s’est terminée avec succès, la DLL des extensions IHV doit définir dwReasonCode sur l’une des options 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.
Remarque Si la DLL des extensions IHV définit dwWin32Error à ERROR_SUCCESS, le système d’exploitation suppose que l’état du port de la session de sécurité est dans un état autorisé. Une fois le port dans un état autorisé, le système d’exploitation autorise l’envoi de tous les paquets de données via l’adaptateur WLAN.
Si l’opération post-association s’est terminée avec un échec, la DLL des 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.
Remarque Si la DLL des extensions IHV ne définit pas dwWin32Error sur ERROR_SUCCESS, le système d’exploitation suppose que l’état du port de la session de sécurité est dans un état non autorisé. Une fois que le port est dans un état non autorisé, le système d’exploitation autorise les paquets de sécurité, y compris les paquets envoyés via le Dot11ExtSendPacket fonction Extensions IHV, à envoyer via l’adaptateur WLAN.
La DLL des extensions IHV doit appeler Dot11ExtPostAssociateCompletion pour annuler toute opération post-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 dwStatus 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)