Compartir a través de

Función WlanSetAutoConfigParameter (wlanapi.h)

  • Artículo

La función WlanSetAutoConfigParameter establece parámetros para el servicio de configuración automática.

Sintaxis

DWORD WlanSetAutoConfigParameter(
  [in] HANDLE               hClientHandle,
  [in] WLAN_AUTOCONF_OPCODE OpCode,
  [in] DWORD                dwDataSize,
  [in] const PVOID          pData,
       PVOID                pReserved
);

Parámetros

[in] hClientHandle

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

[in] OpCode

Valor de WLAN_AUTOCONF_OPCODE que especifica el parámetro que se va a establecer. Solo algunos de los códigos de operación de las operaciones del conjunto de WLAN_AUTOCONF_OPCODE enumeración admiten.

Valor Significado
wlan_autoconf_opcode_show_denied_networks
 Cuando se establece, el parámetro pData contendrá un valor BOOL que indica si las redes de usuario y de grupo denegadas se incluirán en la lista de redes disponibles.
wlan_autoconf_opcode_allow_explicit_creds
 Cuando se establece, el parámetro pData contendrá un valor BOOL que indica si la interfaz inalámbrica actual tiene las credenciales de usuario compartidas permitidas.
wlan_autoconf_opcode_block_period
 Cuando se establece, el parámetro pData contendrá un valor DWORD para la configuración del período bloqueado para la interfaz inalámbrica actual. El período bloqueado es la cantidad de tiempo, en segundos, para el que no se intentará la conexión automática a una red inalámbrica después de un error anterior.
wlan_autoconf_opcode_allow_virtual_station_extensibility
 Cuando se establece, el parámetro pData contendrá un valor BOOL que indica si se permite la extensibilidad en una estación virtual. De forma predeterminada, se permite la extensibilidad en una estación virtual. El valor de este código de operación se conserva entre reinicios.

Este valor de enumeración se admite en Windows 7 y en Windows Server 2008 R2 con el servicio LAN inalámbrico instalado.

[in] dwDataSize

Tamaño del parámetro pData , en bytes. Este parámetro debe establecerse sizeof(BOOL) en para un BOOL o sizeof(DWORD) para un DWORD, en función del valor del parámetro OpCode .

[in] pData

Valor que se va a establecer para el parámetro especificado en el parámetro OpCode . El parámetro pData debe apuntar a un valor booleano o DWORD, dependiendo del valor del parámetro OpCode . El parámetro pData no debe ser NULL.

Nota El parámetro pData puede apuntar a un valor entero cuando se requiere un valor booleano. Si pData apunta a 0, el valor se convierte en FALSE. Si pData apunta a un entero distinto de cero, el valor se convierte en TRUE.
 

pReserved

Reservado para uso futuro. Debe establecerse en 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
 Acceso denegado. Este error se devuelve si el autor de la llamada no tiene permisos suficientes para establecer el parámetro de configuración cuando el parámetro OpCode es wlan_autoconf_opcode_show_denied_networks o wlan_autoconf_opcode_allow_virtual_station_extensibility. Cuando el parámetro OpCode se establece en uno de estos valores, la función WlanSetAutoConfigParameter recupera la lista de control de acceso discrecional (DACL) almacenada para el objeto opcode. Si la DACL no contiene una entrada de control de acceso (ACE) que concede permiso WLAN_WRITE_ACCESS al token de acceso del subproceso de llamada, WlanSetAutoConfigParameter devuelve ERROR_ACCESS_DENIED.

Este error también se devuelve si la directiva de grupo establece el parámetro de configuración en un dominio. Cuando se establece la directiva de grupo para un código de operación, se impide que las aplicaciones realicen cambios. Para los siguientes parámetros de OpCode se pueden establecer mediante la directiva de grupo: wlan_autoconf_opcode_show_denied_networks, wlan_autoconf_opcode_allow_explicit_creds y wlan_autoconf_opcode_block_period
ERROR_INVALID_PARAMETER
 Un parámetro era incorrecto. Este error se devuelve si el parámetro hClientHandle es NULL, el parámetro pData es NULL o el parámetro pReserved no es NULL. Este error también se devuelve si el parámetro OpCode especificado no es uno de los valores de WLAN_AUTOCONF_OPCODE para un parámetro de configuración que se puede establecer. Este error también se devuelve si el parámetro dwDataSize no está establecido sizeof(BOOL)en o dwDataSize no se establece sizeof(BOOL) en según el valor del parámetro OpCode .
ERROR_INVALID_HANDLE
 El identificador hClientHandle no se encontró en la tabla de identificadores.
ERROR_NOT_SUPPORTED
 Se llamó a esta función desde una plataforma no admitida. Este valor se devolverá si se llamó a esta función desde un Windows XP con SP3 o LAN inalámbrica API para Windows XP con el cliente SP2.
RPC_STATUS
 Varios códigos de error.

Comentarios

La función WlanSetAutoConfigParameter establece parámetros usados por el Módulo de configuración automática (ACM), el componente de configuración inalámbrica compatible con Windows Vista y versiones posteriores.

Según el valor del parámetro OpCode , los datos a los que apunta pData se convertirán en un valor booleano antes de establecer el parámetro de configuración automática. Si pData apunta a 0, el parámetro se establece en FALSE; de lo contrario, el parámetro se establece en TRUE.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [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

Consulte también

WLAN_AUTOCONF_OPCODE

WlanQueryAutoConfigParameter