Función WlanOpenHandle (wlanapi.h)

Artículo
08/28/2023

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

Compartir a través de