fonction de rappel DOT11EXTIHV_PERFORM_CAPABILITY_MATCH (wlanihv.h)
Le système d’exploitation appelle la fonction Dot11ExtIhvPerformCapabilityMatch pour demander que la DLL des extensions IHV détermine si un réseau BSS (Basic Service Set) détecté correspond aux extensions de connectivité et de profil de sécurité définies par l’IHV.
Syntaxe
DOT11EXTIHV_PERFORM_CAPABILITY_MATCH Dot11extihvPerformCapabilityMatch;
DWORD Dot11extihvPerformCapabilityMatch(
[in, optional] HANDLE hIhvExtAdapter,
[in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
[in] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
[in] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
[in, optional] 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] 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 contient les paramètres de sécurité du profil IHV.
[in, optional] pConnectableBssid
Pointeur vers une structure DOT11_BSS_LIST, qui contient une ou plusieurs trames de réponse de beacon ou de sonde 802.11 reçues d’un réseau BSS. Cette liste est dérivée des résultats de la dernière opération d’analyse effectuée par l’adaptateur WLAN. Pour plus d’informations sur l’opération d’analyse, consultez Opérations d’analyse natives 802.11.
[out] pdwReasonCode
Pointeur vers une valeur DWORD, qui fournit des informations supplémentaires pour la valeur de retour de la fonction Dot11ExtIhvPerformCapabilityMatch. 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 toutes les entrées de la liste 802.11 Beacon et probe Response frames prennent en charge les attributs de connectivité et de sécurité définis dans les fragments de profil, la fonction retourne ERROR_SUCCESS. Sinon, elle retourne un code d’erreur défini dans Winerror.h.
Remarques
Une fois que l’adaptateur VPN a terminé une opération d’analyse pour détecter les réseaux BSS dans la plage, le système d’exploitation peut appeler la fonction Dot11ExtIhvPerformCapabilityMatch pour déterminer si l’un des réseaux BSS détectés correspond aux extensions de connectivité ou de profil de sécurité définies par l’IHV.
Lorsque la fonction Dot11ExtIhvPerformCapabilityMatch est appelée, la DLL d’extensions IHV doit suivre ces instructions.
-
Si la DLL d’extensions IHV trouve au moins une image de réponse de la sonde ou de la balise IEEE 802.11 qui correspond aux fragments de profil, elle doit définir * pdwReasonCode sur l’une des valeurs 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).
-
Si la DLL des extensions IHV ne trouve pas de trame de réponse ieee 802.11 Beacon ou Sonde qui correspond aux fragments de profil, elle ne doit pas définir *pdwReasonCode sur L2_REASON_CODE_SUCCESS. Au lieu de cela, la DLL doit définir * pdwReasonCode sur l’une des valeurs 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).
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, Winclient.h, L2cmn.h) |