fonction de rappel DOT11EXTIHV_PERFORM_PRE_ASSOCIATE (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.

Le système d’exploitation appelle la fonction Dot11ExtIhvPerformPreAssociate pour demander que la DLL des extensions IHV lance une opération de pré-association avec le réseau BSS (Basic Service Set).

Syntaxe

DOT11EXTIHV_PERFORM_PRE_ASSOCIATE Dot11extihvPerformPreAssociate;

DWORD Dot11extihvPerformPreAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in]           PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDWORD pdwReasonCode
)
{...}

Paramètres

[in, optional] hIhvExtAdapter

Handle utilisé par la DLL d’extensions IHV pour référencer l’adaptateur LAN 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).

[in, optional] pIhvProfileParams

Pointeur vers un structure DOT11EXT_IHV_PROFILE_PARAMS. Cette structure définit les attributs du réseau BSS (Basic Service Set) auquel les extensions de profil seront appliquées.

[in] pIhvConnProfile

Pointeur vers un DOT11EXT_IHV_CONNECTIVITY_PROFILE structure qui contient les paramètres de connectivité pour le profil IHV.

[in] pIhvSecProfile

Pointeur vers un DOT11EXT_IHV_SECURITY_PROFILE structure qui spécifie les paramètres de sécurité pour le profil IHV.

[in] pConnectableBssid

Pointeur vers une structure DOT11_BSS_LIST, qui contient une ou plusieurs trames de réponse de beacon ou de sonde 802.11 pour l’identificateur de jeu de services (SSID) du réseau BSS avec lequel la DLL effectue l’opération de pré-association.

[out] pdwReasonCode

Pointeur vers une valeur DWORD, qui fournit des informations supplémentaires pour la valeur de retour de la fonction Dot11ExtIhvPerformPreAssociate. La DLL des extensions IHV doit définir * pdwReasonCode sur une valeur L2_REASON_CODE_xxxx, qui sont définies dans L2cmn.h.

Valeur de retour

Si la DLL d’extension IHV peut lancer l’opération de pré-association, elle doit effectuer l’opération de manière asynchrone. Dans ce cas, la fonction retourne ERROR_SUCCESS.

Si la DLL des extensions IHV ne peut pas lancer l’opération de pré-association, elle retourne un code d’erreur défini dans Winerror.h.

Remarques

Le système d’exploitation appelle la fonction Dot11ExtIhvPerformPreAssociate pour lancer une opération de pré-association avec la DLL des extensions IHV. Le système d’exploitation lance cette opération avant de lancer une opération de connexion avec un réseau BSS (Basic Service Set) via la carte WLAN. Pour plus d’informations sur l’opération de connexion, consultez opérations de connexion.

L’opération de pré-association doit être effectuée de façon asynchrone à partir de l’appel à Dot11ExtIhvPerformPreAssociate. Une fois l’opération de pré-association terminée, la DLL des extensions IHV doit appeler Dot11ExtPreAssociateCompletion.

Lorsque la fonction Dot11ExtIhvPerformPreAssociate est appelée, la DLL d’extensions IHV doit suivre ces instructions.

Si la DLL des extensions IHV peut lancer l’opération de pré-association, la fonction Dot11ExtIhvPerformPreAssociate doit retourner ERROR_SUCCESS et terminer l’opération de façon asynchrone.
La DLL des extensions IHV fournit plus d’informations sur l’initiation de l’opération de pré-association via le paramètre pdwReasonCode. La DLL doit définir * pdwReasonCode sur l’une des options suivantes :
- L2_REASON_CODE_SUCCESS, si l’opération de pré-association peut être lancée avec succès.
- Valeur d’erreur appropriée L2_REASON_CODE_xxxx si l’opération de pré-association n’a pas pu être lancé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), que l’opération de pré-association puisse être lancée ou non.

Pour plus d’informations sur l’opération de pré-association, consultez opération de pré-association.

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, L2cmn.h)