Compartilhar via


enumeração WLAN_SECURABLE_OBJECT (wlanapi.h)

O WLAN_SECURABLE_OBJECT tipo enumerado define os objetos protegíveis usados pelo Native Wifi Functions.

Esses objetos podem ser protegidos usando WlanSetSecuritySettings. As permissões atuais associadas a esses objetos podem ser recuperadas usando WlanGetSecuritySettings. Para obter mais informações sobre o uso de objetos protegíveis, consulte Como os DACLs controlam o acesso a um objeto.

Syntax

typedef enum _WLAN_SECURABLE_OBJECT {
  wlan_secure_permit_list = 0,
  wlan_secure_deny_list,
  wlan_secure_ac_enabled,
  wlan_secure_bc_scan_enabled,
  wlan_secure_bss_type,
  wlan_secure_show_denied,
  wlan_secure_interface_properties,
  wlan_secure_ihv_control,
  wlan_secure_all_user_profiles_order,
  wlan_secure_add_new_all_user_profiles,
  wlan_secure_add_new_per_user_profiles,
  wlan_secure_media_streaming_mode_enabled,
  wlan_secure_current_operation_mode,
  wlan_secure_get_plaintext_key,
  wlan_secure_hosted_network_elevated_access,
  wlan_secure_virtual_station_extensibility,
  wlan_secure_wfd_elevated_access,
  WLAN_SECURABLE_OBJECT_COUNT
} WLAN_SECURABLE_OBJECT, *PWLAN_SECURABLE_OBJECT;

Constantes

 
wlan_secure_permit_list
Valor: 0
As permissões para modificar a lista de permissões para perfis de usuário.

As LISTAS de controle de acesso discricionário (DACL) associadas a esse objeto protegível são recuperadas quando WlanGetFilterList ou WlanSetFilterList é chamado com wlanFilterListType definido como wlan_filter_list_type_user_permit. Para que a chamada WlanGetFilterList seja bem-sucedida, a DACL deve conter uma ACE (entrada de controle de acesso) que conceda permissão WLAN_READ_ACCESS ao token de acesso do thread de chamada. Para que a chamada WlanSetFilterList seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_deny_list
As permissões para modificar a lista de negação para perfis de usuário. O serviço de configuração automática não estabelecerá uma conexão com uma rede na lista de negação.

O DACL associado a esse objeto protegível é recuperado quando WlanGetFilterList ou WlanSetFilterList é chamado com wlanFilterListType definido como wlan_filter_list_type_user_deny. Para que a chamada WlanGetFilterList seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_READ_ACCESS ao token de acesso do thread de chamada. Para que a chamada WlanSetFilterList seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_ac_enabled
As permissões para habilitar o serviço de configuração automática.

O DACL associado a esse objeto protegível é recuperado quando WlanQueryInterface ou WlanSetInterface é chamado com OpCode definido como wlan_intf_opcode_autoconf_enabled. Para que a chamada WlanQueryInterface seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_READ_ACCESS ao token de acesso do thread de chamada. Para que a chamada WlanSetInterface seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_bc_scan_enabled
As permissões para habilitar verificações em segundo plano.

A DACL associada a esse objeto protegível é recuperada quando WlanQueryInterface ou WlanSetInterface é chamado com OpCode definido como wlan_intf_opcode_background_scan_enabled. Para que a chamada WlanQueryInterface seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_READ_ACCESS ao token de acesso do thread de chamada. Para que a chamada WlanSetInterface seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_bss_type
As permissões para alterar o tipo de conjunto de serviços básico.

A DACL associada a esse objeto protegível é recuperada quando WlanQueryInterface ou WlanSetInterface é chamado com OpCode definido como wlan_intf_opcode_bss_type. Para que a chamada WlanQueryInterface seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_READ_ACCESS ao token de acesso do thread de chamada. Para que a chamada WlanSetInterface seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_show_denied
As permissões para modificar se as redes na lista de negação aparecem na lista de redes disponíveis.

O DACL associado a esse objeto protegível é recuperado quando WlanQueryAutoConfigParameter ou WlanSetAutoConfigParameter é chamado com OpCode definido como wlan_autoconf_opcode_show_denied_networks. Para que a chamada WlanQueryAutoConfigParameter seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_READ_ACCESS ao token de acesso do thread de chamada. Para que a chamada WlanSetAutoConfigParameter seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_interface_properties
As permissões para alterar as propriedades da interface.

Esse é o objeto protegível genérico usado por WlanQueryInterface ou WlanSetInterface quando outro objeto protegível mais específico não é usado. Sua DACL é recuperada sempre que WlanQueryInterface ou WlanSetInterface é o token de acesso do thread de chamada e o OpCode é definido como um valor diferente de wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled, wlan_intf_opcode_media_streaming_mode, wlan_intf_opcode_bss_type ou wlan_intf_opcode_current_operation_mode. A DACL também não é recuperada quando OpCode é definido como wlan_intf_opcode_radio_state e o chamador é o usuário do console.

Para que a chamada WlanQueryInterface seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_READ_ACCESS ao token de acesso do thread de chamada. Para que a chamada WlanSetInterface seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_ihv_control
As permissões para usar a função WlanIhvControl para o controle IHV (fornecedor independente de hardware) de drivers ou serviços WLAN.

A DACL associada a esse objeto protegível é recuperada quando WlanIhvControl é chamado. Para que a chamada seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_all_user_profiles_order
As permissões para modificar a ordem de todos os perfis de usuário.

A DACL associada a esse objeto protegível é recuperada antes de WlanSetProfileList ou WlanSetProfilePosition executar uma operação que altera a ordem relativa de todos os perfis de usuário na lista de perfis ou move um perfil de todos os usuários para uma posição inferior na lista de perfis. Para que qualquer chamada seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_add_new_all_user_profiles
As permissões para adicionar novos perfis de todos os usuários.

Nota O descritor de segurança associado a esse objeto é aplicado a novos perfis de todos os usuários criados.

 

A DACL associada a esse objeto protegível é recuperada quando WlanSetProfile é chamado com dwFlags definido como 0. Para que a chamada seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_add_new_per_user_profiles
As permissões para adicionar novos perfis por usuário.

A DACL associada a esse objeto protegível é recuperada quando WlanSetProfile é chamado com dwFlags definido como WLAN_PROFILE_USER. Para que a chamada seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_media_streaming_mode_enabled
As permissões para definir ou consultar o modo de streaming de mídia.

A DACL associada a esse objeto protegível é recuperada quando WlanQueryInterface ou WlanSetInterface é chamado com OpCode definido como wlan_intf_opcode_media_streaming_mode. Para que a chamada WlanQueryInterface seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_READ_ACCESS ao token de acesso do thread de chamada. Para que a chamada WlanSetInterface seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_current_operation_mode
As permissões para definir ou consultar o modo de operação da interface sem fio.

A DACL associada a esse objeto protegível é recuperada quando WlanQueryInterface ou WlanSetInterface é chamado com OpCode definido como wlan_intf_opcode_current_operation_mode. Para que a chamada WlanQueryInterface seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_READ_ACCESS ao token de acesso do thread de chamada. Para que a chamada WlanSetInterface seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada.
wlan_secure_get_plaintext_key
As permissões para recuperar a chave de texto sem formatação de um perfil sem fio.

A DACL associada a esse objeto protegível é recuperada quando a função WlanGetProfile é chamada com o sinalizador WLAN_PROFILE_GET_PLAINTEXT_KEY definido no valor apontado pelo parâmetro pdwFlags na entrada. Para que a chamada WlanGetProfile seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_READ_ACCESS ao token de acesso do thread de chamada. Por padrão, as permissões para recuperar a chave de texto sem formatação são permitidas apenas para os membros do grupo Administradores em um computador local.



Windows 7: Esse valor é uma extensão para APIs sem fio nativas adicionadas no Windows 7 e posteriores.
wlan_secure_hosted_network_elevated_access
As permissões que têm acesso elevado para chamar as funções de Rede Hospedada privilegiadas.

A DACL associada a esse objeto protegível é recuperada quando a função WlanHostedNetworkSetProperty é chamada com o parâmetro OpCode definido como wlan_hosted_network_opcode_enable. Para que a chamada WlanHostedNetworkSetProperty seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada. Por padrão, a permissão para definir a propriedade rede hospedada sem fio como wlan_hosted_network_opcode_enable é permitida apenas para os membros do grupo Administradores em um computador local.



A DACL associada a esse objeto protegível é recuperada quando a função WlanHostedNetworkForceStart é chamada. Para que a chamada WlanHostedNetworkForceStart seja bem-sucedida, a DACL deve conter um ACE que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada. Por padrão, a permissão para forçar o início da Rede Hospedada sem fio é permitida apenas para os membros do grupo Administradores em um computador local.



Windows 7: Esse valor é uma extensão para APIs sem fio nativas adicionadas no Windows 7 e posteriores.
wlan_secure_virtual_station_extensibility
Windows 7: Esse valor é uma extensão para APIs sem fio nativas adicionadas no Windows 7 e posteriores.
wlan_secure_wfd_elevated_access
Esse valor é reservado para uso interno pelo serviço Wi-Fi Direct.

Windows 8: Esse valor é uma extensão para APIs sem fio nativas adicionadas no Windows 8 e posteriores.
WLAN_SECURABLE_OBJECT_COUNT

Comentários

Esses objetos podem ser protegidos usando WlanSetSecuritySettings. As permissões atuais associadas a esses objetos podem ser recuperadas usando WlanGetSecuritySettings. Para obter mais informações sobre o uso de objetos protegíveis, consulte How DACLs Control Access to an Object and Native Wifi API Permissions( Como o DACLs controla o acesso a um objeto e permissões de API Wifi nativas).

Requisitos

   
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]
Cabeçalho wlanapi.h

Confira também

Como os DACLs controlam o acesso a um objeto

Permissões de API wi-fi nativas

WlanGetFilterList

WlanGetProfile

WlanHostedNetworkForceStart

WlanHostedNetworkSetProperty

WlanIhvControl

WlanQueryAutoConfigParameter

WlanQueryInterface

WlanSetAutoConfigParameter

WlanSetFilterList

WlanSetInterface

WlanSetProfile

WlanSetProfileList

WlanSetProfilePosition