DOT11EXTIHV_PERFORM_CAPABILITY_MATCH fonction de rappel (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 profil de connectivité et 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 des extensions IHV 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] 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 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 balise 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 retournée

Si toutes les entrées de la liste des trames de balise et de réponse de sonde 802.11 prennent en charge les attributs de connectivité et de sécurité définis dans les fragments de profil, la fonction retourne ERROR_SUCCESS. Sinon, il retourne un code d’erreur défini dans Winerror.h.

Remarques

Une fois que l’adaptateur WLAN 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 profil de connectivité ou de sécurité définies par l’IHV.

Lorsque la fonction Dot11ExtIhvPerformCapabilityMatch est appelée, la DLL des extensions IHV doit suivre ces instructions.

• Si la DLL des extensions IHV trouve au moins un cadre de réponse de balise ou de sonde IEEE 802.11 qui correspond aux fragments de profil, elle doit définir * pdwReasonCode 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 fonction Dot11ExtIhvPerformCapabilityMatch doit retourner ERROR_SUCCESS.
• Si la DLL des extensions IHV ne trouve pas de trame de réponse de balise ou de sonde IEEE 802.11 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’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 fonction Dot11ExtIhvPerformCapabilityMatch ne doit pas retourner ERROR_SUCCESS.

Configuration requise

Voir aussi

DOT11EXT_IHV_SECURITY_PROFILE

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_PROFILE_PARAMS