Função WlanSetFilterList (wlanapi.h)

A função WlanSetFilterList define a lista de permissões/negações.

Sintaxe

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

Parâmetros

[in] hClientHandle

O identificador de sessão do cliente, obtido por uma chamada anterior para a função WlanOpenHandle .

[in] wlanFilterListType

Um valor WLAN_FILTER_LIST_TYPE que especifica o tipo de lista de filtros. O valor deve ser wlan_filter_list_type_user_permit ou wlan_filter_list_type_user_deny. As listas definidas pela política de grupo não podem ser definidas usando essa função.

[in, optional] pNetworkList

Ponteiro para uma estrutura DOT11_NETWORK_LIST que contém a lista de redes a serem permitidas ou negadas. O membro dwIndex da estrutura deve ter um valor menor que o valor do membro dwNumberOfItems da estrutura; caso contrário, poderá ocorrer uma violação de acesso.

pReserved

Reservado para uso futuro. Deve ser definido como NULL.

Retornar valor

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de retorno.

Código de retorno	Descrição
ERROR_ACCESS_DENIED	O chamador não tem permissões suficientes para definir a lista de filtros. Quando chamado com wlanFilterListType definido como wlan_filter_list_type_user_permit, WlanSetFilterList recupera a DACL (lista de controle de acesso discricionário) armazenada com o objeto wlan_secure_permit_list . Quando chamado com wlanFilterListType definido como wlan_filter_list_type_user_deny, WlanSetFilterList recupera a DACL armazenada com o objeto wlan_secure_deny_list . Em qualquer um desses casos, se a DACL não contiver uma ACE (entrada de controle de acesso) que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada, wlanSetFilterList retornará ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle é NULL ou inválido ou pReserved não é NULL.
ERROR_INVALID_HANDLE	O identificador hClientHandle não foi encontrado na tabela de identificador.
ERROR_NOT_SUPPORTED	Essa função foi chamada de uma plataforma sem suporte. Esse valor será retornado se essa função for chamada de um Windows XP com SP3 ou API lan sem fio para Windows XP com cliente SP2.
RPC_STATUS	Vários códigos de erro.

Comentários

As listas de permissões e negações da política de grupo têm precedência sobre as listas de permissões e negações do usuário. Isso significa que o acesso a uma rede na lista de permissões do usuário será negado se a rede aparecer na lista de negação de política de grupo. Da mesma forma, o acesso a uma rede na lista de negação do usuário será permitido se a rede aparecer na lista de permissões de política de grupo. Redes que não estão em uma lista de usuários ou em uma lista de políticas de grupo serão permitidas.

As redes negadas não podem ser conectadas por meio de configuração automática e não serão incluídas na lista de redes visíveis. Novas listas de permissões e negações de usuário substituem versões anteriores das listas de usuários.

Para limpar uma lista de filtros, defina o parâmetro pNetworkList como NULL ou passe um ponteiro para uma estrutura DOT11_NETWORK_LIST que tenha o membro dwNumberOfItems definido como 0.

Para adicionar todos os SSIDs a uma lista de filtros, passe um ponteiro para uma estrutura DOT11_NETWORK_LIST com uma estrutura DOT11_NETWORK associada que tenha o membro uSSIDLength de sua estrutura DOT11_SSID definida como 0.

Para adicionar todos os tipos BSS a uma lista de filtros, passe um ponteiro para um DOT11_NETWORK_LIST com uma estrutura DOT11_NETWORK associada que tenha seu membro dot11BssType definido como dot11_BSS_type_any.

Os comandos de filtro netsh wlan add filter e netsh wlan delete fornecem funcionalidade semelhante na linha de comando. Para obter mais informações, consulte Comandos netsh para rede local sem fio (wlan).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wlanapi.h (inclua Wlanapi.h)
Biblioteca	Wlanapi.lib
DLL	Wlanapi.dll

Confira também

WlanGetFilterList