DOT11EXT_SET_CURRENT_PROFILE función de devolución de llamada (wlanihv.h)

  • Artículo
Importante La interfaz LAN inalámbrica nativa 802.11 está en desuso en Windows 10 y versiones posteriores. En su lugar, use la interfaz del controlador de dispositivos WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador universal de Windows WLAN.
 
El archivo DLL de extensiones de IHV llama a la función Dot11ExtSetCurrentProfile para especificar la configuración de los fragmentos de perfil de seguridad y conectividad definidos por IHV. Estos fragmentos se aplicarán al perfil de red actual.

Sintaxis

DOT11EXT_SET_CURRENT_PROFILE Dot11extSetCurrentProfile;

DWORD Dot11extSetCurrentProfile(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in, optional] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
)
{...}

Parámetros

[in, optional] hDot11SvcHandle

Identificador utilizado por el sistema operativo para hacer referencia al adaptador LAN inalámbrico (WLAN). Este valor de identificador se especificó a través de una llamada anterior a la función Dot11ExtIhvInitAdapter IHV Handler.

[in, optional] hConnectSession

Identificador utilizado por el sistema operativo para hacer referencia a la sesión de conexión con la red básica del conjunto de servicios (BSS). Este valor de identificador se especificó a través de una llamada anterior a . Dot11ExtIhvPerformPreAssociate Función de controlador de IHV.

[in, optional] pIhvConnProfile

Puntero a DOT11EXT_IHV_CONNECTIVITY_PROFILE estructura que contiene la configuración de conectividad del perfil de IHV.

[in, optional] pIhvSecProfile

Puntero a DOT11EXT_IHV_SECURITY_PROFILE estructura que especifica la configuración de seguridad para el perfil de IHV.

Valor devuelto

Si la llamada se realiza correctamente, la función devuelve ERROR_SUCCESS. De lo contrario, devuelve un código de error definido en Winerror.h.

Comentarios

La función Dot11ExtSetCurrentProfile permite que el IHV agregue fragmentos de perfil de seguridad y conectividad personalizados al perfil de red actual que se usa para la conexión de red básica del conjunto de servicios (BSS). Los fragmentos de perfil son específicos de IHV y son aplicables a las extensiones de conectividad o seguridad disponibles para el usuario a través del archivo DLL de extensiones de interfaz de usuario IHV nativas 802.11.

El archivo DLL de extensiones de IHV debe seguir estas directrices al llamar a la función Dot11ExtSetCurrentProfile :

  • El archivo DLL de extensiones de IHV solo debe llamar a Dot11ExtSetCurrentProfile al realizar una operación de asociación previa iniciada a través de una llamada a . Dot11ExtIhvPerformPreAssociate Función de controlador de IHV. Para obtener más información sobre la operación previa a la asociación, vea Operación previa a la asociación.
  • El archivo DLL de extensiones de IHV no debe llamar a Dot11ExtSetCurrentProfile desde la llamada a . Dot11ExtIhvPerformPreAssociate Función de controlador de IHV. Se debe llamar a Dot11ExtSetCurrentProfile desde un subproceso diferente al que está procesando la llamada a Dot11ExtIhvPerformPreAssociate.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino Escritorio
Encabezado wlanihv.h (incluya Wlanihv.h)

Consulte también

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Dot11ExtIhvPerformPreAssociate DOT11EXT_IHV_CONNECTIVITY_PROFILE