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

Artículo
03/05/2024

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 sistema operativo llama a la función Dot11ExtIhvCreateDiscoveryProfiles para devolver fragmentos de perfil de seguridad y conectividad temporales que se podrían usar para conectarse a una red de conjunto de servicios básico (BSS) para la que no existe un perfil de red.

Sintaxis

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
)
{...}

Parámetros

[in, optional] hIhvExtAdapter

Identificador utilizado por el archivo DLL de extensiones IHV 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] bInsecure

Valor booleano que especifica el estado de seguridad de los perfiles de detección. Si se establece en TRUE, el archivo DLL de extensiones de IHV solo puede devolver perfiles seguros, como los perfiles que implican la autenticación del usuario.

[in, optional] pIhvProfileParams

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

[in, optional] pConnectableBssid

Puntero a una estructura de DOT11_BSS_LIST , que contiene uno o varios marcos de baliza o de sondeo de 802.11 recibidos de una red BSS. Esta lista se deriva de los resultados de la última operación de examen realizada por el adaptador WLAN. Para obtener más información sobre la operación de examen, consulte Operaciones de examen nativas 802.11.

Nota Para Windows Vista, el archivo DLL de extensiones de IHV solo admite redes de conjunto de servicios básicos de infraestructura (BSS).

[out] pIhvDiscoveryProfileList

Puntero a DOT11EXT_IHV_DISCOVERY_PROFILE_LIST estructura que especifica una lista de perfiles de detección de IHV.

[out] pdwReasonCode

Puntero a un valor DWORD, que proporciona información adicional para el valor devuelto de la función Dot11ExtIhvCreateDiscoveryProfiles . El archivo DLL de extensiones de 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

Una vez que el adaptador WLAN completa una operación de examen, el sistema operativo podría llamar a Dot11ExtIhvCreateDiscoveryProfiles para crear fragmentos de perfil temporales que se podrían usar para conectarse a una red BSS para la que el usuario no ha creado un perfil de red.

Cuando se llama a Dot11ExtIhvCreateDiscoveryProfiles , el archivo DLL de extensiones de IHV debe seguir estas instrucciones.

Si el archivo DLL de extensiones de IHV puede devolver fragmentos de perfil que se pueden usar para conectarse a la red BSS, la función Dot11ExtIhvCreateDiscoveryProfiles 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 el resultado devuelto de la función Dot11ExtIhvCreateDiscoveryProfiles . El archivo DLL debe establecer * pdwReasonCode en uno de los siguientes elementos:
- L2_REASON_CODE_SUCCESS, si se pueden devolver fragmentos de perfil para la lista de redes BSS.
- Un valor de error de L2_REASON_CODE_xxxx adecuado, si los fragmentos de perfil no se pueden devolver para la lista de redes BSS.
- 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 si se devuelven fragmentos de perfil.

Para obtener más información sobre cómo crear perfiles de detección, consulte Creación de extensiones de perfil de red.

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, Winclient.h, L2cmn.h)