Compartir a través de

Función WlanSetFilterList (wlanapi.h)

  • Artículo

La función WlanSetFilterList establece la lista de permisos y denegación.

Sintaxis

DWORD WlanSetFilterList(
  [in]           HANDLE                    hClientHandle,
  [in]           WLAN_FILTER_LIST_TYPE     wlanFilterListType,
  [in, optional] const PDOT11_NETWORK_LIST pNetworkList,
                 PVOID                     pReserved
);

Parámetros

[in] hClientHandle

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

[in] wlanFilterListType

Valor de WLAN_FILTER_LIST_TYPE que especifica el tipo de lista de filtros. El valor debe ser wlan_filter_list_type_user_permit o wlan_filter_list_type_user_deny. Las listas definidas por directivas de grupo no se pueden establecer mediante esta función.

[in, optional] pNetworkList

Puntero a una estructura de DOT11_NETWORK_LIST que contiene la lista de redes para permitir o denegar. El miembro dwIndex de la estructura debe tener un valor menor que el valor del miembro dwNumberOfItems de la estructura; De lo contrario, puede producirse una infracción de acceso.

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
 El autor de la llamada no tiene permisos suficientes para establecer la lista de filtros.

Cuando se llama con wlanFilterListType establecido en wlan_filter_list_type_user_permit, WlanSetFilterList recupera la lista de control de acceso discrecional (DACL) almacenada con el objeto wlan_secure_permit_list . Cuando se llama a con wlanFilterListType establecido en wlan_filter_list_type_user_deny, WlanSetFilterList recupera la DACL almacenada con el objeto wlan_secure_deny_list . En cualquiera de estos casos, si la DACL no contiene una entrada de control de acceso (ACE) que concede permiso WLAN_WRITE_ACCESS al token de acceso del subproceso que realiza la llamada, WlanSetFilterList devuelve ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER
 hClientHandle es NULL o no válido o pReserved no es NULL.
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

Las listas de permisos y denegación de directiva de grupo tienen prioridad sobre las listas de permisos y denegación del usuario. Esto significa que se denegará el acceso a una red en la lista de permisos del usuario si la red aparece en la lista de denegación de directiva de grupo. Del mismo modo, se permitirá el acceso a una red en la lista de denegación del usuario si la red aparece en la lista de permisos de directiva de grupo. Se permitirán las redes que no están en una lista de usuarios o una lista de directivas de grupo.

Las redes denegadas no se pueden conectar mediante la configuración automática y no se incluirán en la lista de redes visibles. Las nuevas listas de permisos y denegación de usuario sobrescriben las versiones anteriores de las listas de usuarios.

Para borrar una lista de filtros, establezca el parámetro pNetworkList en NULL o pase un puntero a una estructura de DOT11_NETWORK_LIST que tenga el miembro dwNumberOfItems establecido en 0.

Para agregar todos los SSID a una lista de filtros, pase un puntero a una estructura de DOT11_NETWORK_LIST con una estructura de DOT11_NETWORK asociada que tenga el miembro uSSIDLength de su estructura de DOT11_SSID establecida en 0.

Para agregar todos los tipos BSS a una lista de filtros, pase un puntero a un DOT11_NETWORK_LIST con una estructura de DOT11_NETWORK asociada que tenga su miembro dot11BssType establecido en dot11_BSS_type_any.

Los comandos netsh wlan add filter y netsh wlan delete filter proporcionan una funcionalidad similar en la línea de comandos. Para obtener más información, consulta Netsh Commands for Wireless Local Area Network (wlan).

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

WlanGetFilterList