DOT11EXT_PRE_ASSOCIATE_COMPLETION fonction de rappel (wlanihv.h)

La DLL des extensions IHV appelle la fonction Dot11ExtPreAssociateCompletion pour effectuer de façon asynchrone une opération de pré-association initiée par un appel à Dot11ExtIhvPerformPreAssociate Fonction de gestionnaire IHV.

Syntaxe

DOT11EXT_PRE_ASSOCIATE_COMPLETION Dot11extPreAssociateCompletion;

DWORD Dot11extPreAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

Paramètres

[in, optional] hDot11SvcHandle

Handle utilisé par le système d’exploitation 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, optional] hConnectSession

Handle utilisé par le système d’exploitation pour référencer la session de connexion avec le réseau BSS (Basic Service Set). Cette valeur de handle a été spécifiée lors d’un appel précédent à Dot11ExtIhvPerformPreAssociate Fonction de gestionnaire IHV.

[in] dwReasonCode

Valeur qui fournit des informations supplémentaires pour l’achèvement status de l’opération de pré-association. La DLL extensions IHV doit définir dwReasonCode sur une valeur L2_REASON_CODE_xxxx, qui sont définies dans L2cmn.h.

La DLL extensions IHV retourne la saisie semi-automatique générale status de l’opération de pré-association via le paramètre dwWin32Error. En règle générale, la DLL Extensions IHV définit dwReasonCode sur une valeur comprise entre L2_REASON_CODE_IHV_BASE et (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).

[in] dwWin32Error

L’achèvement status de l’opération de pré-association telle que définie par un code d’erreur dans Winerror.h. Si l’opération se termine correctement, la DLL des extensions IHV doit définir dwWin32Error sur ERROR_SUCCESS.

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

La DLL des extensions IHV doit suivre ces instructions lors de l’appel de la fonction Dot11ExtPreAssociateCompletion .

• Si l’opération de pré-association s’est terminée avec succès, la DLL des extensions IHV doit définir dwReasonCode 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).
  Dans ce cas, la DLL des extensions IHV doit définir dwWin32Error sur ERROR_SUCCESS.
• Si l’opération de pré-association s’est terminée avec un échec, la DLL des extensions IHV ne doit pas définir dwReasonCode sur L2_REASON_CODE_SUCCESS. Au lieu de cela, la DLL doit définir dwReasonCode sur l’une des valeurs suivantes :
  • Valeur d’erreur L2_REASON_CODE_xxxx appropriée.
  • 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).
  Dans ce cas, la DLL des extensions IHV ne doit pas définir dwWin32Error sur ERROR_SUCCESS. Au lieu de cela, la DLL doit définir dwWin32Error sur un code d’erreur approprié défini dans Winerror.h
• La DLL extensions IHV doit appeler Dot11ExtPreAssociateCompletion pour annuler toutes les opérations de pré-association en attente chaque fois que les fonctions de gestionnaire IHV Dot11ExtIhvAdapterReset ou Dot11ExtIhvDeinitAdapter IHV sont appelées. Dans ce cas, la DLL doit définir le paramètre dwWin32Error sur ERROR_CANCELLED.

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)

Voir aussi

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

Fonctions de gestionnaire IHV 802.11 natives

Dot11ExtIhvPerformPreAssociate