Compartir a través de

estructura WLAN_CONNECTION_PARAMETERS (wlanapi.h)

  • Artículo

La estructura WLAN_CONNECTION_PARAMETERS especifica los parámetros usados al usar la función WlanConnect .

Sintaxis

typedef struct _WLAN_CONNECTION_PARAMETERS {
  WLAN_CONNECTION_MODE wlanConnectionMode;
#if ...
  LPCWSTR              strProfile;
#else
  LPCWSTR              strProfile;
#endif
  PDOT11_SSID          pDot11Ssid;
  PDOT11_BSSID_LIST    pDesiredBssidList;
  DOT11_BSS_TYPE       dot11BssType;
  DWORD                dwFlags;
} WLAN_CONNECTION_PARAMETERS, *PWLAN_CONNECTION_PARAMETERS;

Miembros

wlanConnectionMode

Valor de WLAN_CONNECTION_MODE que especifica el modo de conexión.

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: Solo se admite el valor de wlan_connection_mode_profile .

strProfile

Especifica el perfil que se usa para la conexión.

Si wlanConnectionMode se establece en wlan_connection_mode_profile, strProfile especifica el nombre del perfil usado para la conexión. Si wlanConnectionMode se establece en wlan_connection_mode_temporary_profile, strProfile especifica la representación XML del perfil usado para la conexión. Si wlanConnectionMode está establecido en wlan_connection_mode_discovery_secure o wlan_connection_mode_discovery_unsecure, strProfile debe establecerse en NULL.

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: El perfil debe cumplir los criterios de compatibilidad descritos en Compatibilidad de perfiles inalámbricos.

pDot11Ssid

Puntero a una estructura de DOT11_SSID que especifica el SSID de la red al que conectarse. Este parámetro es opcional. Cuando se establece en NULL, se probarán todos los SSID del perfil. Este parámetro no debe ser NULL si WLAN_CONNECTION_MODE está establecido en wlan_connection_mode_discovery_secure o wlan_connection_mode_discovery_unsecure.

pDesiredBssidList

Puntero a una estructura de DOT11_BSSID_LIST que contiene la lista de identificadores de conjunto de servicios básicos (BSS) deseados para la conexión.

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: Este miembro debe ser NULL.

dot11BssType

Valor DOT11_BSS_TYPE que indica el tipo BSS de la red. Si se proporciona un perfil, este tipo de BSS debe ser el mismo que el del perfil.

dwFlags

En la tabla siguiente se muestran las marcas usadas para especificar los parámetros de conexión.

Constante Valor Descripción
WLAN_CONNECTION_HIDDEN_NETWORK 0x00000001 Conéctese a la red de destino incluso si el destino es una red oculta. Una red oculta no difunde su SSID. No use esta marca si la red de destino es una red ad hoc. Si el perfil especificado por strProfile no es NULL, se omite esta marca y el elemento de perfil nonBroadcast determina si se va a conectar a una red oculta.
WLAN_CONNECTION_ADHOC_JOIN_ONLY 0x00000002 No formes una red ad hoc. Solo se une a una red ad hoc si la red ya existe. No use esta marca si la red de destino es una red de infraestructura.
WLAN_CONNECTION_IGNORE_PRIVACY_BIT 0x00000004 Ignore el bit de privacidad al conectarse a la red. Omitir el bit de privacidad tiene el efecto de ignorar si los paquetes se cifran e ignoran el método de cifrado usado. Use esta marca solo al conectarse a una red de infraestructura mediante un perfil temporal.
WLAN_CONNECTION_EAPOL_PASSTHROUGH 0x00000008 Eximir el tráfico de EAPOL del cifrado y el descifrado. Esta marca se usa cuando una aplicación debe enviar tráfico EAPOL a través de una red de infraestructura que usa autenticación abierta y cifrado WEP. Esta marca no se debe usar para conectarse a redes que requieren autenticación 802.1X. Esta marca solo es válida cuando wlanConnectionMode está establecido en wlan_connection_mode_temporary_profile. Evite usar esta marca siempre que sea posible.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE 0x00000010 Persista automáticamente el perfil de detección al finalizar correctamente la conexión. Esta marca solo es válida para wlan_connection_mode_discovery_secure o wlan_connection_mode_discovery_unsecure. El perfil se guardará como un perfil de usuario completo, con el nombre generado a partir del SSID mediante WlanUtf8SsidToDisplayName. Si ya hay un perfil con el mismo nombre, se anexará un número al final del nombre del perfil. El perfil se guardará con el modo de conexión manual, a menos que también se especifique WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO 0x00000020 Para usarse junto con WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE. El perfil de detección se conservará con el modo de conexión automática.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_OVERWRITE_EXISTING 0x00000040 Para usarse junto con WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE. El perfil de detección se conservará e intentará sobrescribir un perfil existente con el mismo nombre.
 

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: Este miembro debe establecerse en 0.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista, Windows XP con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado wlanapi.h
Redistribuible API LAN inalámbrica para Windows XP con SP2

Consulte también

WlanConnect