Directrices previas a la operación de asociación

El archivo DLL de extensiones de IHV debe seguir estas instrucciones al realizar la operación de asociación previa.

• Cuando se llama a la función Dot11ExtIhvPerformPreAssociate , el archivo DLL de extensiones de IHV debe hacer lo siguiente:

  • Compruebe las extensiones de IHV para el perfil de conectividad y seguridad. Si los parámetros de perfil no son válidos, la función Dot11ExtIhvPerformPreAssociate devuelve un código de error adecuado tal como se define en Winerror.h.
  • Cree e inicie un nuevo subproceso para completar la operación de asociación previa. Dado que la operación de asociación previa debe completarse de forma asincrónica desde la llamada a Dot11ExtIhvPerformPreAssociate, el archivo DLL de extensiones de IHV debe llamar a Dot11ExtPreAssociateCompletion desde este subproceso una vez completada la operación.
  • Devuelve ERROR_SUCCESS de la llamada de función. En este momento, se notifica al sistema operativo que el perfil de red es válido y que la operación previa a la asociación está en curso.

• El archivo DLL de extensiones de IHV puede llamar a la función Dot11ExtNicSpecificExtension para configurar el adaptador inalámbrico LAN (WLAN). Se puede llamar a esta función desde dentro de la llamada a Dot11ExtIhvPerformPreAssociate o desde el subproceso que controla la operación de asociación previa después de que Dot11ExtIhvPerformPreAssociate devuelva.

• Las llamadas a Dot11ExtSetProfileCustomUserData, Dot11ExtGetProfileCustomUserData y Dot11ExtSetCurrentProfile no deben realizarse desde la llamada a Dot11ExtIhvPerformPreAssociate. Estas funciones solo se pueden llamar después de que Dot11ExtIhvPerformPreAssociate devuelva ERROR_SUCCESS.

• Una vez que el archivo DLL de extensiones de IHV llama a Dot11ExtPreAssociateCompletion para completar la operación de asociación previa, el identificador de la sesión de conexión ya no es válido. El sistema operativo pasa este identificador a través del parámetro hConnectSession de Dot11ExtIhvPerformPreAssociate. El archivo DLL no debe usar este valor de identificador al llamar a cualquier función de extensibilidad de IHV que declare un parámetro hConnectSession .

  Para obtener más información sobre las funciones de extensibilidad de IHV, consulte Funciones nativas de extensibilidad de IHV 802.11.

• Si se llama a la función Dot11ExtIhvAdapterReset, el archivo DLL de extensiones de IHV debe cancelar la operación de asociación previa llamando a Dot11ExtPreAssociateCompletion. Para obtener más información sobre la operación de restablecimiento, consulta 802.11 Restablecimiento del adaptador WLAN.

• Si se llama a la función Dot11ExtIhvDeinitAdapter, el archivo DLL de extensiones de IHV debe cancelar internamente la operación de preasociación. Sin embargo, no debe llamar a ninguna de las funciones de extensibilidad de IHV que solo se pueden llamar después de la inicialización del adaptador, incluido Dot11ExtPreAssociateCompletion.