DOT11EXT_POST_ASSOCIATE_COMPLETION fonction de rappel (wlanihv.h)

Article
08/08/2023

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez plutôt l’interface WDI (WLAN Device Driver Interface). Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

La DLL des extensions IHV appelle la fonction Dot11ExtPostAssociateCompletion pour effectuer de manière asynchrone une opération de post-association lancée via un appel à Dot11ExtIhvPerformPostAssociate Fonction de 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 LAN sans fil (WLAN). Cette valeur de handle a été spécifiée lors d’un appel précédent à la fonction gestionnaire IHV Dot11ExtIhvInitAdapter .

[in, optional] hSecuritySessionID

Handle de l’identificateur de session de sécurité (ID) retourné par un appel précédent au Dot11ExtIhvPerformPostAssociate Fonction de gestionnaire IHV.

[in, optional] pPeer

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

Note Pour Windows Vista, la DLL des 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’achèvement status de l’opération post-association. La DLL des extensions IHV doit définir dwReasonCode sur une valeur L2_REASON_CODE_xxxx, qui est définie dans L2cmn.h.

La DLL des extensions IHV retourne l’status 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

L’achèvement status de l’opération post-association telle que 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 retournée

Si l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, il 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 :

Terminez l’opération post-association initiée par un appel au Dot11ExtIhvPerformPostAssociate Fonction de gestionnaire IHV.
Une fois l’opération post-association terminée, indiquez une modification de l’état du port pour 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’un des éléments suivants :
- L2_REASON_CODE_SUCCESS.
- Valeur définie par IHV dans la plage de L2_REASON_CODE_IHV_BASE à (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.
Note Si la DLL des extensions IHV définit dwWin32Error sur ERROR_SUCCESS, le système d’exploitation suppose que l’état du port de la session de sécurité est autorisé. Une fois que le port est 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’un des éléments suivants :
- Valeur d’erreur L2_REASON_CODE_xxxx appropriée.
- Valeur définie par IHV dans la plage de L2_REASON_CODE_IHV_BASE à (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.
Note 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 l’envoi de paquets de sécurité, y compris les paquets envoyés via la fonction d’extensions IHV Dot11ExtSendPacket , via l’adaptateur WLAN.
La DLL extensions IHV doit appeler Dot11ExtPostAssociateCompletion pour annuler toutes les opérations post-association en attente chaque fois que les fonctions de gestionnaire IHV Dot11ExtIhvAdapterReset ou Dot11ExtIhvDeinitAdapter Sont appelées. Dans ce cas, la DLL doit définir le paramètre dwStatus sur ERROR_CANCELLED.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wlanihv.h (inclure Wlanihv.h)