DOT11EXTIHV_VALIDATE_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 dispositivo WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador de Windows universal WLAN.
 
El sistema operativo llama a la función Dot11ExtIhvValidateProfile para validar los datos de usuario especificados para un perfil de red. El archivo DLL de extensiones de IHV solo es responsable de comprobar los datos de los fragmentos del perfil de conectividad y seguridad definido por el IHV.

Sintaxis

DOT11EXTIHV_VALIDATE_PROFILE Dot11extihvValidateProfile;

DWORD Dot11extihvValidateProfile(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [out]          PDWORD pdwReasonCode
)
{...}

Parámetros

[in, optional] hIhvExtAdapter

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

[in, optional] pIhvProfileParams

Puntero a DOT11EXT_IHV_PROFILE_PARAMS estructura. Esta estructura define los atributos de la red del conjunto de servicios básico (BSS) a la que se aplicarán las extensiones de perfil.

[in] pIhvConnProfile

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

[in] pIhvSecProfile

Puntero a DOT11EXT_IHV_SECURITY_PROFILE estructura que contiene la configuración de seguridad del perfil de IHV.

[out] pdwReasonCode

Puntero a un valor DWORD, que proporciona información adicional para el valor devuelto de la función Dot11ExtIhvValidateProfile . El archivo DLL de extensiones IHV debe establecer * pdwReasonCode en un valor de L2_REASON_CODE_xxxx, que se definen en L2cmn.h.

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

El sistema operativo llama a la función Dot11ExtIhvValidateProfile para comprobar la configuración especificada por el usuario para un perfil de red antes de que se procese o guarde el perfil.

Cuando se llama a la función Dot11ExtIhvValidateProfile , el archivo DLL de extensiones de IHV sigue estas directrices:

  • El archivo DLL de extensiones de IHV comprueba que la configuración de perfil especificada por el usuario es válida para los atributos generales de la red del conjunto de servicios básico (BSS) a la que se aplicará el perfil. Se hace referencia a los atributos de red BSS a través del parámetro pIhvProfileParams .
  • Si los datos de usuario son válidos para las extensiones de perfil de red, Dot11ExtIhvValidateProfile debe devolver ERROR_SUCCESS. De lo contrario, la función debe devolver un código de error adecuado de los valores de ERROR_xxxx definidos en Winerror.h.
  • El archivo DLL de extensiones de IHV proporciona más información sobre los resultados de la validación de los datos de usuario. El archivo DLL debe establecer * pdwReasonCode en uno de los siguientes elementos:
    • L2_REASON_CODE_SUCCESS, si los datos de usuario son válidos.
    • Valor de error de L2_REASON_CODE_xxxx adecuado, si los datos del usuario no son válidos.
    • Valor definido por IHV en el intervalo de L2_REASON_CODE_IHV_BASE a (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1), independientemente de la validez de los datos del usuario.
Para obtener más información sobre el esquema XML native 802.11, consulte la documentación de Microsoft Windows SDK.

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 (incluye Wlanihv.h, L2cmn.h)

Consulte también

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_PROFILE_PARAMS

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE