DOT11EXTIHV_CREATE_DISCOVERY_PROFILES fonction de rappel (wlanihv.h)

Article
08/08/2023

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 Dot11ExtIhvCreateDiscoveryProfiles pour retourner des fragments temporaires de connectivité et de profil de sécurité qui peuvent être utilisés pour se connecter à un réseau BSS (Basic Service Set) pour lequel aucun profil réseau n’existe.

Syntaxe

DOT11EXTIHV_CREATE_DISCOVERY_PROFILES Dot11extihvCreateDiscoveryProfiles;

DWORD Dot11extihvCreateDiscoveryProfiles(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           BOOL bInsecure,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDOT11EXT_IHV_DISCOVERY_PROFILE_LIST pIhvDiscoveryProfileList,
  [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] bInsecure

Valeur booléenne qui spécifie le status de sécurité des profils de découverte. Si la valeur est TRUE, la DLL des extensions IHV peut uniquement retourner des profils sécurisés, tels que les profils qui impliquent l’authentification de l’utilisateur.

[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, 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 extensions IHV prend uniquement en charge les réseaux BSS (Infrastructure Basic Service Set).

[out] pIhvDiscoveryProfileList

Pointeur vers un DOT11EXT_IHV_DISCOVERY_PROFILE_LIST structure qui spécifie une liste de profils de découverte IHV.

[out] pdwReasonCode

Pointeur vers une valeur DWORD, qui fournit des informations supplémentaires pour la valeur de retour de la fonction Dot11ExtIhvCreateDiscoveryProfiles . 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 l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, elle retourne un code d’erreur défini dans Winerror.h.

Remarques

Une fois que l’adaptateur WLAN a terminé une opération d’analyse, le système d’exploitation peut appeler Dot11ExtIhvCreateDiscoveryProfiles pour créer des fragments de profil temporaires qui peuvent être utilisés pour se connecter à un réseau BSS pour lequel aucun profil réseau n’a été créé par l’utilisateur.

Lorsque Dot11ExtIhvCreateDiscoveryProfiles est appelé, la DLL des extensions IHV doit suivre ces instructions.

Si la DLL des extensions IHV peut retourner des fragments de profil qui peuvent être utilisés pour se connecter au réseau BSS, la fonction Dot11ExtIhvCreateDiscoveryProfiles doit retourner ERROR_SUCCESS. Sinon, la fonction doit retourner un code d’erreur approprié à partir des valeurs ERROR_xxxx définies dans Winerror.h.
La DLL extensions IHV fournit plus d’informations sur le résultat de retour de la fonction Dot11ExtIhvCreateDiscoveryProfiles . La DLL doit définir * pdwReasonCode sur l’une des valeurs suivantes :
- L2_REASON_CODE_SUCCESS, si des fragments de profil peuvent être retournés pour la liste des réseaux BSS.
- Valeur d’erreur L2_REASON_CODE_xxxx appropriée, si les fragments de profil ne peuvent pas être retournés pour la liste des réseaux BSS.
- 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 les fragments de profil soient retournés ou non.

Pour plus d’informations sur la création de profils de découverte, consultez Création d’extensions de profil réseau.

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