Compartir a través de

Función WlanConnect (wlanapi.h)

  • Artículo

La función WlanConnect intenta conectarse a una red específica.

Sintaxis

DWORD WlanConnect(
  [in] HANDLE                            hClientHandle,
  [in] const GUID                        *pInterfaceGuid,
  [in] const PWLAN_CONNECTION_PARAMETERS pConnectionParameters,
       PVOID                             pReserved
);

Parámetros

[in] hClientHandle

El identificador de sesión del cliente, devuelto por una llamada anterior a la función WlanOpenHandle .

[in] pInterfaceGuid

GUID de la interfaz que se va a usar para la conexión.

[in] pConnectionParameters

Puntero a una estructura de WLAN_CONNECTION_PARAMETERS que especifica el tipo de conexión, el modo, el perfil de red, el SSID que identifica la red y otros parámetros.

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: Hay algunas restricciones en los miembros de WLAN_CONNECTION_PARAMETERS . Esto significa que es posible que las estructuras que sean válidas para Windows Server 2008 y Windows Vista no sean válidas para Windows XP con SP3 o la API LAN inalámbrica para Windows XP con SP2. Para obtener una lista de restricciones, consulte WLAN_CONNECTION_PARAMETERS.

pReserved

Reservado para uso futuro. Debe establecerse en NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de retorno.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Se produjo una de las siguientes condiciones:
  • hClientHandle es NULL o no es válido.
  • pInterfaceGuid es NULL.
  • pConnectionParameters es NULL.
  • El miembro dwFlags de la estructura a la que apunta pConnectionParameters no se establece en uno de los valores especificados en la página de WLAN_CONNECTION_PARAMETERS .
  • El miembro wlanConnectionMode de la estructura a la que apunta pConnectionParameters se establece en wlan_connection_mode_discovery_secure o wlan_connection_mode_discovery_unsecure, y el miembro pDot11Ssid de la misma estructura es NULL.
  • El miembro wlanConnectionMode de la estructura a la que apunta pConnectionParameters se establece en wlan_connection_mode_discovery_secure o wlan_connection_mode_discovery_unsecure, y el miembro dot11BssType de la misma estructura se establece en dot11_BSS_type_any.
  • El miembro wlanConnectionMode de la estructura a la que apunta pConnectionParameters se establece en wlan_connection_mode_profile, y el miembro strProfile de la misma estructura es NULL o la longitud del perfil supera WLAN_MAX_NAME_LENGTH.
  • El miembro wlanConnectionMode de la estructura a la que apunta pConnectionParameters se establece en wlan_connection_mode_profile, y el miembro strProfile de la misma estructura es NULL o la longitud del perfil es cero.
  • El miembro wlanConnectionMode de la estructura a la que apunta pConnectionParameters se establece en wlan_connection_mode_invalid o wlan_connection_mode_auto.
  • El miembro dot11BssType de la estructura a la que apunta pConnectionParameters se establece en dot11_BSS_type_infrastructure y el miembro dwFlags de la misma estructura se establece en WLAN_CONNECTION_ADHOC_JOIN_ONLY.
  • El miembro dot11BssType de la estructura a la que apunta pConnectionParameters se establece en dot11_BSS_type_independent y el miembro dwFlags de la misma estructura se establece en WLAN_CONNECTION_HIDDEN_NETWORK.
  • El miembro dwFlags de la estructura a la que apunta pConnectionParameters se establece en WLAN_CONNECTION_IGNORE_PRIVACY_BIT, y el miembro wlanConnectionMode de la misma estructura no se establece en wlan_connection_mode_temporary_profile o el miembro dot11BssType de la misma estructura se establece en dot11_BSS_type_independent.
ERROR_INVALID_HANDLE
 El identificador hClientHandle no se encontró en la tabla de identificadores.
RPC_STATUS
 Varios códigos de error.
ERROR_ACCESS_DENIED
 El autor de la llamada no tiene permisos suficientes.

Observaciones

La función WlanConnect devuelve inmediatamente. Para recibir una notificación cuando se establece una conexión o cuando no se intenten más conexiones, un cliente debe registrarse para recibir notificaciones mediante una llamada a WlanRegisterNotification.

El miembro strProfile de la estructura WLAN_CONNECTION_PARAMETERS a la que apunta pConnectionParameters especifica el perfil que se va a usar para la conexión. Si este perfil es un perfil de todo el usuario, el autor de la llamada WlanConnect debe tener acceso de ejecución en el perfil. De lo contrario, se producirá un error en la llamada a WlanConnect con el valor devuelto ERROR_ACCESS_DENIED. Los permisos de un perfil de usuario completo se establecen cuando se crea o guarda el perfil mediante WlanSetProfile o WlanSaveTemporaryProfile.

Para realizar una operación de conexión en la línea de comandos, use el comando netsh wlan connect . Para obtener más información, consulta Netsh Commands for Wireless Local Area Network (wlan).

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: Solo puede usar WlanConnect para conectarse a redes en la lista de redes preferidas. Para agregar una red a la lista de redes preferidas, llame a WlanSetProfile.

Requisitos

   
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]
Plataforma de destino Windows
Encabezado wlanapi.h (incluya Wlanapi.h)
Library Wlanapi.lib
Archivo DLL Wlanapi.dll
Redistribuible API LAN inalámbrica para Windows XP con SP2

Consulte también

WLAN_CONNECTION_PARAMETERS

WlanDisconnect