enumeração WLAN_SECURABLE_OBJECT (wlanapi.h)

Artigo
08/28/2023

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

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