fonction de rappel DOT11EXTIHV_CREATE_DISCOVERY_PROFILES (wlanihv.h)
Le système d’exploitation appelle les Dot11ExtIhvCreateDiscoveryProfiles fonction pour retourner des fragments de connectivité temporaire et de profil de sécurité qui peuvent être utilisés pour se connecter à un réseau BSS (Basic Service Set) pour lequel un profil réseau n’existe pas.
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 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] bInsecure
Valeur booléenne qui spécifie l’état de sécurité des profils de découverte. Si elle est définie sur TRUE, la DLL des extensions IHV ne peut retourner que des profils sécurisés, tels que des profils qui impliquent l’authentification utilisateur.
[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, 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] 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 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 l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, elle retourne un code d’erreur défini dans Winerror.h.
Remarques
Une fois l’opération d’analyse terminée, 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 un profil réseau n’a pas été créé par l’utilisateur.
Lorsque Dot11ExtIhvCreateDiscoveryProfiles est appelée, la DLL d’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 des 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 options suivantes :
- L2_REASON_CODE_SUCCESS, si des fragments de profil peuvent être retournés pour la liste des réseaux BSS.
- Valeur d’erreur appropriée L2_REASON_CODE_xxxx, 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.
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) |