DOT11EXTIHV_PERFORM_PRE_ASSOCIATE fonction de rappel (wlanihv.h)

Article
03/01/2024

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

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 des extensions IHV pour référencer l’adaptateur LAN sans fil (WLAN). Cette valeur de handle a été spécifiée par le biais d’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 DOT11EXT_IHV_PROFILE_PARAMS structure. 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 balise ou de réponse de sonde 802.11 pour l’identificateur de jeu de services (SSID) du réseau BSS avec lequel la DLL effectuera 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 extensions IHV doit définir * pdwReasonCode sur une valeur L2_REASON_CODE_xxxx, qui sont définies dans L2cmn.h.

Valeur retournée

Si la DLL d’extension IHV peut lancer l’opération de pré-association, elle doit terminer 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 d’initier 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 manière 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 des 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 manière asynchrone.
La DLL 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 valeurs suivantes :
- L2_REASON_CODE_SUCCESS, si l’opération de pré-association peut être lancée avec succès.
- Valeur d’erreur L2_REASON_CODE_xxxx appropriée si l’opération de pré-association n’a pas pu être lancée.
- 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), que l’opération de pré-association ait pu être lancée ou non.

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

Configuration requise

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