DOT11EXTIHV_PERFORM_CAPABILITY_MATCH fonction de rappel (wlanihv.h)

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.

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.

Note Pour Windows Vista, la DLL des extensions IHV prend uniquement en charge les réseaux BSS (Infrastructure Basic Service Set).

[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.
Pour plus d’informations sur le schéma XML Native 802.11, reportez-vous à la documentation Microsoft Windows SDK.

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

Voir aussi

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_SECURITY_PROFILE

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_PROFILE_PARAMS