Compartir a través de

Función WlanGetFilterList (wlanapi.h)

  • Artículo

La función WlanGetFilterList recupera una directiva de grupo o una lista de permisos de usuario.

Sintaxis

DWORD WlanGetFilterList(
  [in]  HANDLE                hClientHandle,
  [in]  WLAN_FILTER_LIST_TYPE wlanFilterListType,
        PVOID                 pReserved,
  [out] PDOT11_NETWORK_LIST   *ppNetworkList
);

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. Se pueden consultar todas las listas de filtros de directiva de grupo y definidas por el usuario.

pReserved

Reservado para uso futuro. Debe establecerse en NULL.

[out] ppNetworkList

Puntero a una estructura de DOT11_NETWORK_LIST que contiene la lista de redes permitidas o denegadas.

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 la lista de filtros.

Cuando se llama con wlanFilterListType establecido en wlan_filter_list_type_user_permit, WlanGetFilterList recupera la lista de control de acceso discrecional (DACL) almacenada con el objeto wlan_secure_permit_list . Cuando se llama con wlanFilterListType establecido en wlan_filter_list_type_user_deny, WlanGetFilterList 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_READ_ACCESS al token de acceso del subproceso de llamada, WlanGetFilterList devuelve ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER
 hClientHandle es NULL o no es válido, ppNetworkList es NULL 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 de usuario se pueden establecer llamando a WlanSetFilterList.

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

DOT11_NETWORK_LIST

WLAN_FILTER_LIST_TYPE

WlanSetFilterList