Función WlanHostedNetworkInitSettings (wlanapi.h)

Artículo
03/04/2024

La función WlanHostedNetworkInitSettings configura y persiste en el almacenamiento de las opciones de conexión de red (SSID y número máximo de elementos del mismo nivel, por ejemplo) en la red hospedada inalámbrica si estas opciones aún no están configuradas.

Sintaxis

DWORD WlanHostedNetworkInitSettings(
  [in]            HANDLE                      hClientHandle,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

Parámetros

[in] hClientHandle

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

[out, optional] pFailReason

Puntero opcional a un valor que recibe el motivo del error si se produce un error en la llamada a la función WlanHostedNetworkInitSettings . Los valores posibles por el motivo del error proceden del tipo de enumeración WLAN_HOSTED_NETWORK_REASON definido en el archivo de encabezado Wlanapi.h .

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 de identificadores.
ERROR_INVALID_PARAMETER	Un parámetro es incorrecto. Este error se devuelve si se produce alguna de las condiciones siguientes: hClientHandle es NULL. pvReserved no es NULL.
ERROR_INVALID_STATE	El recurso no está en el estado correcto para realizar la operación solicitada.
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 del error devuelto.

Comentarios

La función WlanHostedNetworkInitSettings 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 WlanHostedNetworkInitSettings para configurar y conservar para almacenar las opciones de conexión de red (SSID y el número máximo de elementos del mismo nivel, por ejemplo) en la red hospedada inalámbrica, si las opciones de conexión aún no están configuradas. Si la configuración de red de la red inalámbrica hospedada ya está configurada (la función WlanHostedNetworkQueryProperty no devuelve ERROR_BAD_CONFIGURATION para el perfil de estación o la configuración de conexión), esta llamada de función devuelve ERROR_SUCCESS sin cambiar la configuración de la configuración de la conexión de red.

Una aplicación cliente siempre debe llamar a la función WlanHostedNetworkInitSettings antes de usar otras características de red hospedada en el equipo local. Esta función inicializa la configuración necesaria cuando la red hospedada inalámbrica se usa por primera vez en un equipo local. La función WlanHostedNetworkInitSettings no cambia ninguna configuración si la configuración ya se ha conservado. Por lo tanto, es seguro llamar a la función WlanHostedNetworkInitSettings si la configuración ya se ha conservado. Se recomienda que las aplicaciones que usan la red hospedada llamen a la función WlanHostedNetworkInitSettings antes de usar otras funciones de red hospedada.

La función WlanHostedNetworkInitSettings calcula un SSID aleatorio y legible desde el nombre de host y calcula una clave principal aleatoria. Esta función también usa establece un valor para el número máximo de elementos del mismo nivel permitidos que tiene como valor predeterminado 100. Si una aplicación quiere usar un SSID diferente o un número máximo diferente de elementos del mismo nivel, la aplicación debe llamar a la función WlanHostedNetworkSetProperty para establecer específicamente estas propiedades usadas por la red hospedada inalámbrica.

Cualquier cambio de estado de red hospedada causado por esta función no se deshacería automáticamente si la aplicación que realiza la llamada cierra su identificador de llamada (llamando a WlanCloseHandle con el parámetro hClientHandle ) o si finaliza el proceso.

Cualquier usuario puede llamar a la función WlanHostedNetworkInitSettings para configurar y conservar la configuración de conexión de red de almacenamiento en la red hospedada. Si la red hospedada inalámbrica ya se ha configurado, esta función no hace nada y devuelve ERROR_SUCCESS.

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 red Connections" como "Conexión de red inalámbrica 2" con un nombre de dispositivo de "Adaptador de miniporte de Microsoft Virtual WiFi" 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