Compartilhar via

Função WlanSetAutoConfigParameter (wlanapi.h)

  • Artigo

A função WlanSetAutoConfigParameter define parâmetros para o serviço de configuração automática.

Sintaxe

DWORD WlanSetAutoConfigParameter(
  [in] HANDLE               hClientHandle,
  [in] WLAN_AUTOCONF_OPCODE OpCode,
  [in] DWORD                dwDataSize,
  [in] const PVOID          pData,
       PVOID                pReserved
);

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 WLAN_AUTOCONF_OPCODE que especifica o parâmetro a ser definido. Somente alguns dos opcodes na enumeração WLAN_AUTOCONF_OPCODE dão suporte a operações de conjunto.

Valor Significado
wlan_autoconf_opcode_show_denied_networks
 Quando definido, o parâmetro pData conterá um valor BOOL que indica se as redes negadas pela política de usuário e grupo serão incluídas na lista de redes disponíveis.
wlan_autoconf_opcode_allow_explicit_creds
 Quando definido, o parâmetro pData conterá um valor BOOL que indica se a interface sem fio atual tem credenciais de usuário compartilhadas permitidas.
wlan_autoconf_opcode_block_period
 Quando definido, o parâmetro pData conterá um valor DWORD para a configuração de período bloqueado para a interface sem fio atual. O período bloqueado é a quantidade de tempo, em segundos, para a 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 pData 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 é persistido entre reinicializações.

Esse valor de enumeração tem suporte no Windows 7 e no Windows Server 2008 R2 com o Serviço lan sem fio instalado.

[in] dwDataSize

O tamanho do parâmetro pData , em bytes. Esse parâmetro deve ser definido sizeof(BOOL) como para um BOOL ou sizeof(DWORD) para um DWORD, dependendo do valor do parâmetro OpCode .

[in] pData

O valor a ser definido para o parâmetro especificado no parâmetro OpCode . O parâmetro pData deve apontar para um valor booliano ou DWORD, dependendo do valor do parâmetro OpCode . O parâmetro pData não deve ser NULL.

Nota O parâmetro pData pode apontar para um valor inteiro quando um booliano é necessário. Se pData apontar para 0, o valor será convertido em FALSE. Se pData apontar para um inteiro diferente de zero, o valor será convertido em TRUE.
 

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
 Acesso negado. Esse erro será retornado se o chamador não tiver permissões suficientes para definir o parâmetro de configuração quando o parâmetro OpCode for wlan_autoconf_opcode_show_denied_networks ou wlan_autoconf_opcode_allow_virtual_station_extensibility. Quando o parâmetro OpCode é definido como um desses valores, a função WlanSetAutoConfigParameter recupera a DACL (lista de controle de acesso discricionário) armazenada para o objeto opcode. 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, WlanSetAutoConfigParameter retornará ERROR_ACCESS_DENIED.

Esse erro também será retornado se o parâmetro de configuração for definido pela política de grupo em um domínio. Quando a política de grupo é definida para um opcode, os aplicativos são impedidos de fazer alterações. Para os seguintes parâmetros OpCode podem ser definidos pela política de grupo: wlan_autoconf_opcode_show_denied_networks, wlan_autoconf_opcode_allow_explicit_creds e wlan_autoconf_opcode_block_period
ERROR_INVALID_PARAMETER
 Um parâmetro era ruim. Esse erro será retornado se o parâmetro hClientHandle for NULL, o parâmetro pData for NULL ou o parâmetro pReserved não for NULL. Esse erro também será retornado se o parâmetro OpCode especificado não for um dos valores de WLAN_AUTOCONF_OPCODE para um parâmetro de configuração que pode ser definido. Esse erro também será retornado se o parâmetro dwDataSize não estiver definido sizeof(BOOL)como ou o dwDataSize não estiver definido como sizeof(BOOL) dependendo do valor do parâmetro OpCode .
ERROR_INVALID_HANDLE
 O identificador hClientHandle não foi encontrado na tabela de identificadores.
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 WlanSetAutoConfigParameter define parâmetros usados pelo Módulo de Configuração Automática (ACM), o componente de configuração sem fio com suporte no Windows Vista e posterior.

Dependendo do valor do parâmetro OpCode , os dados apontados por pData serão convertidos em um valor booliano antes que o parâmetro de configuração automática seja definido. Se pData apontar para 0, o parâmetro será definido como FALSE; caso contrário, o parâmetro será definido como TRUE.

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

WlanQueryAutoConfigParameter