Compartir a través de

Función WlanOpenHandle (wlanapi.h)

  • Artículo

La función WlanOpenHandle abre una conexión con el servidor.

Sintaxis

DWORD WlanOpenHandle(
  [in]  DWORD   dwClientVersion,
        PVOID   pReserved,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

Parámetros

[in] dwClientVersion

La versión más alta de la API WLAN que admite el cliente.

Value Significado
1
 Versión de cliente para Windows XP con SP3 e API LAN inalámbrica para Windows XP con SP2.
2
 Versión de cliente para Windows Vista y Windows Server 2008

pReserved

Reservado para uso futuro. Debe establecerse en NULL.

[out] pdwNegotiatedVersion

Versión de la API WLAN que se usará en esta sesión. Este valor suele ser la versión más alta compatible con el cliente y el servidor.

[out] phClientHandle

Identificador para que el cliente lo use en esta sesión. Otras funciones de la sesión usan este identificador.

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
 pdwNegotiatedVersion es NULL, phClientHandle es NULL o pReserved no es NULL.
ERROR_NOT_ENOUGH_MEMORY
 No se pudo asignar memoria para crear el contexto de cliente.
RPC_STATUS
 Varios códigos de error.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED
 El servidor ha emitido demasiados identificadores.

Observaciones

El número de versión especificado por dwClientVersion y pdwNegotiatedVersion es un número de versión compuesto formado por versiones principales y secundarias. La versión principal se especifica mediante la palabra de orden bajo y la versión secundaria se especifica mediante la palabra de orden superior. Las macros WLAN_API_VERSION_MAJOR(_v) y WLAN_API_VERSION_MINOR(_v) devuelven los números de versión principal y secundaria respectivamente. Puede construir un número de versión mediante la macro WLAN_API_MAKE_VERSION(_major, _minor).

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: WlanOpenHandle devolverá un mensaje de error si el servicio Wireless Zero Configuration (WZC) no se ha iniciado o si el servicio WZC no responde.

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

WlanCloseHandle