Función WlanQueryAutoConfigParameter (wlanapi.h)

La función WlanQueryAutoConfigParameter consulta los parámetros del servicio de configuración automática.

Sintaxis

DWORD WlanQueryAutoConfigParameter(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_AUTOCONF_OPCODE    OpCode,
                  PVOID                   pReserved,
  [out]           PDWORD                  pdwDataSize,
  [out]           PVOID                   *ppData,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pWlanOpcodeValueType
);

Parámetros

[in] hClientHandle

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

[in] OpCode

Valor que especifica el parámetro de configuración que se va a consultar.

Valor	Significado
wlan_autoconf_opcode_show_denied_networks	Cuando se establece, el parámetro ppData contendrá un valor BOOL que indica si las redes de usuario y de grupo denegadas se incluirán en la lista de redes disponibles. Si la función devuelve ERROR_SUCCESS y ppData apunta a TRUE, las redes de directiva de usuario y grupo denegadas se incluirán en la lista de redes disponibles; si false, las redes de directiva de usuario y grupo denegadas no se incluirán en la lista de redes disponibles.
wlan_autoconf_opcode_power_setting	Cuando se establece, el parámetro ppData contendrá un valor de WLAN_POWER_SETTING que especifica la configuración de energía.
wlan_autoconf_opcode_only_use_gp_profiles_for_allowed_networks	Cuando se establece, el parámetro ppData contendrá un valor BOOL que indica si los perfiles no creados por la directiva de grupo se pueden usar para conectarse a una red permitida con un perfil de directiva de grupo coincidente. Si la función devuelve ERROR_SUCCESS y ppData apunta a TRUE, solo se pueden usar los perfiles creados por la directiva de grupo; si es FALSE, se puede usar cualquier perfil.
wlan_autoconf_opcode_allow_explicit_creds	Cuando se establece, el parámetro ppData contendrá un valor BOOL que indica si la interfaz inalámbrica actual tiene permitidas las credenciales de usuario compartidas. Si la función devuelve ERROR_SUCCESS y ppData apunta a TRUE, la interfaz inalámbrica actual tiene permitidas las credenciales de usuario compartidas; si es FALSE, la interfaz inalámbrica actual no permite credenciales de usuario compartidas.
wlan_autoconf_opcode_block_period	Cuando se establece, el parámetro ppData contendrá un valor DWORD que indica el valor 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 ppData 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. Si la función devuelve ERROR_SUCCESS y ppData apunta a TRUE, se permite la extensibilidad en una estación virtual; si es FALSE, no se permite la extensibilidad en una estación virtual.

pReserved

Reservado para uso futuro. Debe establecerse en NULL.

[out] pdwDataSize

Especifica el tamaño del parámetro ppData , en bytes.

[out] ppData

Puntero a la memoria que contiene el valor consultado del parámetro especificado en OpCode.

Nota Si OpCode se establece en wlan_autoconf_opcode_show_denied_networks, el puntero al que hace referencia ppData puede apuntar a un valor entero. Si el puntero al que hace referencia ppData apunta a 0, el valor entero se debe convertir en el valor booleano FALSE. Si el puntero al que hace referencia ppData apunta a un entero distinto de cero, el valor entero se debe convertir en el valor booleano TRUE.

 

[out, optional] pWlanOpcodeValueType

Valor de WLAN_OPCODE_VALUE_TYPE .

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 para obtener parámetros de configuración. Cuando se llama con OpCode establecido en wlan_autoconf_opcode_show_denied_networks, WlanQueryAutoConfigParameter recupera la lista de control de acceso discrecional (DACL) almacenada con el objeto wlan_secure_show_denied . Si la DACL no contiene una entrada de control de acceso (ACE) que concede WLAN_READ_ACCESS permiso al token de acceso del subproceso de llamada, WlanQueryAutoConfigParameter devuelve ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle es NULL o no es válido, pReserved no es NULL, ppData es NULL o pdwDataSize es NULL.
ERROR_INVALID_HANDLE	No se encontró el identificador hClientHandle en la tabla handle.
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 la API de LAN inalámbrica para Windows XP con el cliente SP2.
RPC_STATUS	Varios códigos de error.

Comentarios

La función WlanQueryAutoConfigParameter consulta los parámetros utilizados por el módulo de configuración automática (ACM), el componente de configuración inalámbrica compatible con Windows Vista y versiones posteriores.

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

WlanSetAutoConfigParameter