Compartilhar via

Função WlanGetFilterList (wlanapi.h)

  • Artigo

A função WlanGetFilterList recupera uma política de grupo ou uma lista de permissões de usuário.

Sintaxe

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

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. Todas as listas de filtros de política de grupo e definidas pelo usuário podem ser consultadas.

pReserved

Reservado para uso futuro. Deve ser definido como NULL.

[out] ppNetworkList

Ponteiro para uma estrutura DOT11_NETWORK_LIST que contém a lista de redes permitidas ou negadas.

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

Quando chamado com wlanFilterListType definido como wlan_filter_list_type_user_permit, WlanGetFilterList 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, WlanGetFilterList 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_READ_ACCESS ao token de acesso do thread de chamada, WlanGetFilterList retornará ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER
 hClientHandle é NULL ou inválido, ppNetworkList é NULL 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 de usuário podem ser definidas chamando WlanSetFilterList.

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

DOT11_NETWORK_LIST

WLAN_FILTER_LIST_TYPE

WlanSetFilterList