Compartilhar via

Função WlanQueryAutoConfigParameter (wlanapi.h)

  • Artigo

A função WlanQueryAutoConfigParameter consulta os parâmetros do serviço de configuração automática.

Sintaxe

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

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

[in] OpCode

Um valor que especifica o parâmetro de configuração a ser consultado.

Valor Significado
wlan_autoconf_opcode_show_denied_networks
 Quando definido, o parâmetro ppData conterá um valor BOOL que indica se as redes negadas por política de usuário e grupo serão incluídas na lista de redes disponíveis.

Se a função retornar ERROR_SUCCESS e ppData apontar para TRUE, as redes negadas por política de usuário e grupo serão incluídas na lista de redes disponíveis; se as redes false, de usuário e de política de grupo não forem incluídas na lista de redes disponíveis.
wlan_autoconf_opcode_power_setting
 Quando definido, o parâmetro ppData conterá um valor WLAN_POWER_SETTING especificando as configurações de energia.
wlan_autoconf_opcode_only_use_gp_profiles_for_allowed_networks
 Quando definido, o parâmetro ppData conterá um valor BOOL que indica se os perfis não criados pela política de grupo podem ser usados para se conectar a uma rede permitida com um perfil de política de grupo correspondente.

Se a função retornar ERROR_SUCCESS e ppData apontar para TRUE, somente os perfis criados pela política de grupo poderão ser usados; se FALSE, qualquer perfil poderá ser usado.
wlan_autoconf_opcode_allow_explicit_creds
 Quando definido, o parâmetro ppData conterá um valor BOOL que indica se a interface sem fio atual tem credenciais de usuário compartilhadas permitidas.

Se a função retornar ERROR_SUCCESS e ppData apontar para TRUE, a interface sem fio atual terá credenciais de usuário compartilhadas permitidas; se FALSE, a interface sem fio atual não permitirá credenciais de usuário compartilhadas.
wlan_autoconf_opcode_block_period
 Quando definido, o parâmetro ppData conterá um valor DWORD que indica a configuração de período bloqueado para a interface sem fio atual. O período bloqueado é a quantidade de tempo, em segundos, para o qual a conexão automática com uma rede sem fio não será tentada após uma falha anterior.
wlan_autoconf_opcode_allow_virtual_station_extensibility
 Quando definido, o parâmetro ppData conterá um valor BOOL que indica se a extensibilidade em uma estação virtual é permitida. Por padrão, a extensibilidade em uma estação virtual é permitida. O valor desse opcode é persistente entre reinicializações.

Se a função retornar ERROR_SUCCESS e ppData apontar para TRUE, a extensibilidade em uma estação virtual será permitida; se FALSE, a extensibilidade em uma estação virtual não será permitida.

pReserved

Reservado para uso futuro. Deve ser definido como NULL.

[out] pdwDataSize

Especifica o tamanho do parâmetro ppData , em bytes.

[out] ppData

Ponteiro para a memória que contém o valor consultado para o parâmetro especificado em OpCode.

Nota Se OpCode for definido como wlan_autoconf_opcode_show_denied_networks, o ponteiro referenciado por ppData poderá apontar para um valor inteiro. Se o ponteiro referenciado por ppData apontar para 0, o valor inteiro deverá ser convertido no valor booliano FALSE. Se o ponteiro referenciado por ppData apontar para um inteiro diferente de zero, o valor inteiro deverá ser convertido no valor booliano TRUE.
 

[out, optional] pWlanOpcodeValueType

Um valor WLAN_OPCODE_VALUE_TYPE .

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 parâmetros de configuração.

Quando chamado com OpCode definido como wlan_autoconf_opcode_show_denied_networks, WlanQueryAutoConfigParameter recupera a DACL (lista de controle de acesso discricionário) armazenada com o objeto wlan_secure_show_denied . 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, WlanQueryAutoConfigParameter retornará ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER
 hClientHandle é NULL ou inválido, pReserved não é NULL, ppData é NULL ou pdwDataSize é 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

A função WlanQueryAutoConfigParameter consulta os parâmetros usados pelo ACM (Módulo de Configuração Automática), o componente de configuração sem fio com suporte no Windows Vista e posteriores.

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

WLAN_AUTOCONF_OPCODE

WlanSetAutoConfigParameter