Función WlanHostedNetworkSetProperty (wlanapi.h)

Artículo
03/15/2023

La función WlanHostedNetworkSetProperty establece propiedades estáticas de la red hospedada inalámbrica.

Sintaxis

DWORD WlanHostedNetworkSetProperty(
  [in]            HANDLE                      hClientHandle,
  [in]            WLAN_HOSTED_NETWORK_OPCODE  OpCode,
  [in]            DWORD                       dwDataSize,
  [in]            PVOID                       pvData,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

Parámetros

[in] hClientHandle

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

[in] OpCode

Identificador de la propiedad que se va a establecer. Este identificador solo puede ser los siguientes valores en la enumeración WLAN_HOSTED_NETWORK_OPCODE definida en el archivo de encabezado Wlanapi.h :

wlan_hosted_network_opcode_connection_settings

La configuración de conexión de red hospedada.

wlan_hosted_network_opcode_enable

Marca habilitada para la red hospedada.

[in] dwDataSize

Valor que especifica el tamaño, en bytes, del búfer al que apunta el parámetro pvData .

[in] pvData

Puntero a un búfer con la propiedad estática que se va a establecer. El tipo de datos asociado a este búfer depende del valor del parámetro OpCode .

[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 WlanHostedNetworkSetProperty . Los valores posibles para 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_ACCESS_DENIED	El autor de la llamada no tiene permisos suficientes. Este error también se devuelve si el parámetro OpCode se wlan_hosted_network_opcode_enable y la red hospedada inalámbrica está deshabilitada por la directiva de grupo en un dominio.
ERROR_BAD_PROFILE	El perfil de conexión de red utilizado por la red hospedada inalámbrica está dañado.
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. OpCode no es uno de los valores enumerados definidos en el WLAN_HOSTED_NETWORK_OPCODE. dwDataSize es cero. pvData es NULL. pvData no apunta a una propiedad estática bien formada. 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_NOT_SUPPORTED	No se admite la solicitud. Este error se devuelve si la aplicación llama a la función WlanHostedNetworkSetProperty con el parámetro OpCode establecido en wlan_hosted_network_opcode_station_profile o wlan_hosted_network_opcode_security_settings.
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 WlanHostedNetworkSetProperty 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 WlanHostedNetworkSetProperty para establecer las propiedades estáticas actuales de la red hospedada inalámbrica. Cualquier cambio de propiedad de red hospedada causada 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 el proceso finaliza.

El tipo de datos asociado al búfer al que apunta el parámetro pvData depende del valor del parámetro OpCode de la siguiente manera:

OpCode	Descripción
wlan_hosted_network_opcode_connection_settings	Un puntero a una estructura de WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS se pasa en el parámetro pvData .
wlan_hosted_network_opcode_enable	Se pasa un puntero a BOOL en el parámetro pvData .

Si se llama a la función WlanHostedNetworkSetProperty con el parámetro OpCode establecido en wlan_hosted_network_opcode_enable, el usuario debe tener el privilegio asociado adecuado. Los permisos se almacenan en una lista de control de acceso discrecional (DACL) asociada a un WLAN_SECURABLE_OBJECT. Para llamar a la función WlanHostedNetworkSetProperty con el parámetro OpCode de wlan_hosted_network_opcode_enable, el token de acceso de cliente del llamador debe tener privilegios elevados expuestos por la siguiente enumeración en WLAN_SECURABLE_OBJECT:

wlan_secure_hosted_network_elevated_access

Si la función WlanHostedNetworkSetProperty se pasa cualquiera de los siguientes valores en el parámetro OpCode , se producirá un error en la función con ERROR_NOT_SUPPORTED:

wlan_hosted_network_opcode_station_profile
wlan_hosted_network_opcode_connection_settings

Para tener éxito, la función WlanHostedNetworkSetProperty debe conservar la nueva configuración que requiere que el estado de la red hospedada se cambie a wlan_hosted_network_idle si se estaba ejecutando actualmente (wlan_hosted_network_active).

Cualquier usuario puede llamar a esta función para establecer las propiedades de la red hospedada. Sin embargo, para establecer la marca wlan_hosted_network_opcode_enable requiere privilegios elevados. La capacidad de habilitar la red hospedada inalámbrica también 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