Función WlanHostedNetworkQueryStatus (wlanapi.h)

Artículo
08/28/2023

La función WlanHostedNetworkQueryStatus consulta el estado actual de la red hospedada inalámbrica.

Sintaxis

DWORD WlanHostedNetworkQueryStatus(
  [in]  HANDLE                      hClientHandle,
  [out] PWLAN_HOSTED_NETWORK_STATUS *ppWlanHostedNetworkStatus,
        PVOID                       pvReserved
);

Parámetros

[in] hClientHandle

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

[out] ppWlanHostedNetworkStatus

En la entrada, este parámetro debe ser NULL.

En la salida, este parámetro recibe un puntero al estado actual de la red hospedada inalámbrica, si la llamada a la función WlanHostedNetworkQueryStatus se realiza correctamente. El estado actual se devuelve en una estructura de WLAN_HOSTED_NETWORK_STATUS .

pvReserved

Reservado para uso futuro. Este parámetro debe ser 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_HANDLE	Un identificador no es válido. Este error se devuelve si no se encontró el identificador especificado en el parámetro hClientHandle en la tabla handle.
ERROR_INVALID_PARAMETER	Un parámetro es incorrecto. Este error se devuelve si se produce alguna de las condiciones siguientes: hClientHandle es NULL. ppWlanHostedNetworkStatus es NULL. pvReserved no es NULL.
ERROR_INVALID_STATE	El recurso no está en el estado correcto para realizar la operación solicitada. Esto puede ocurrir si la red hospedada inalámbrica estaba en proceso de apagado.
ERROR_SERVICE_NOT_ACTIVE	El servicio no se ha iniciado. Este error se devuelve si el servicio WLAN AutoConfig no se está ejecutando.
Otros	Varios rpc y otros códigos de error. Use FormatMessage para obtener la cadena de mensaje para el error devuelto.

Comentarios

La función WlanHostedNetworkQueryStatus es una extensión de las API inalámbricas nativas agregadas para admitir la red inalámbrica hospedada en Windows 7 y en Windows Server 2008 R2 con el servicio LAN inalámbrico instalado.

Una aplicación cliente llama a la función WlanHostedNetworkQueryStatus para consultar el estado actual de la red hospedada inalámbrica. Esta función no cambia el estado de la red hospedada inalámbrica.

Si la función se ejecuta correctamente, el parámetro ppWlanHostedNetworkStatus apunta a una estructura de WLAN_HOSTED_NETWORK_STATUS con el estado actual. La memoria usada para la estructura WLAN_HOSTED_NETWORK_STATUS que se devuelve debe liberarse después de su uso llamando a la función WlanFreeMemory .

Cualquier usuario puede llamar a la función WlanHostedNetworkQueryStatus para consultar la red hospedada. Sin embargo, la capacidad de habilitar la red hospedada inalámbrica puede estar restringida por la directiva de grupo en un dominio.

En Windows 7 y versiones posteriores, el sistema operativo instala un dispositivo virtual si un adaptador inalámbrico compatible con red hospedada está presente en la máquina. Este dispositivo virtual aparece normalmente en la "Carpeta de Connections de red" como "Conexión de red inalámbrica 2" con un nombre de dispositivo de "Adaptador de miniporte de WiFi virtual de Microsoft" si el equipo tiene un único adaptador de red inalámbrica. Este dispositivo virtual se usa exclusivamente para realizar conexiones de punto de acceso de software (SoftAP) y no está presente en la lista devuelta por la función WlanEnumInterfaces . La duración de este dispositivo virtual está vinculada al adaptador inalámbrico físico. Si el adaptador inalámbrico físico está deshabilitado, este dispositivo virtual también se quitará. Esta característica también está disponible en Windows Server 2008 R2 con el servicio LAN inalámbrico instalado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wlanapi.h (incluya Wlanapi.h)
Library	Wlanapi.lib
Archivo DLL	Wlanapi.dll