WLAN_SECURABLE_OBJECT 열거형(wlanapi.h)

아티클
08/28/2023

WLAN_SECURABLE_OBJECT 열거형 형식은 Native Wifi Functions에서 사용하는 보안 개체를 정의합니다.

이러한 개체는 WlanSetSecuritySettings를 사용하여 보호될 수 있습니다. 이러한 개체와 연결된 현재 권한은 WlanGetSecuritySettings를 사용하여 검색할 수 있습니다. 보안 개체 사용에 대한 자세한 내용은 DACLs가 개체에 대한 액세스를 제어하는 방법을 참조하세요.

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;

상수


`wlan_secure_permit_list` 값: 0 사용자 프로필에 대한 허용 목록을 수정하기 위한 권한입니다. WlanGetFilterList 또는 WlanSetFilterList가 wlan_filter_list_type_user_permit 설정된 wlanFilterListType을 사용하여 호출될 때 이 보안 개체와 연결된 DACL(임의 액세스 제어 목록)이 검색됩니다. WlanGetFilterList 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_READ_ACCESS 권한을 부여하는 ACE(액세스 제어 항목)가 포함되어야 합니다. WlanSetFilterList 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_deny_list` 사용자 프로필에 대한 거부 목록을 수정하기 위한 권한입니다. 자동 구성 서비스는 거부 목록에서 네트워크에 대한 연결을 설정하지 않습니다. WlanGetFilterList 또는 WlanSetFilterList가 wlanFilterListType이 wlan_filter_list_type_user_deny 설정된 상태에서 호출될 때 이 보안 개체와 연결된 DACL이 검색됩니다. WlanGetFilterList 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_READ_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다. WlanSetFilterList 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_ac_enabled` 자동 구성 서비스를 사용하도록 설정하기 위한 권한입니다. 이 보안 개체와 연결된 DACL은 OpCode가 wlan_intf_opcode_autoconf_enabled 설정된 상태에서 WlanQueryInterface 또는 WlanSetInterface를 호출할 때 검색됩니다. WlanQueryInterface 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_READ_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다. WlanSetInterface 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_bc_scan_enabled` 백그라운드 검사를 사용하도록 설정하기 위한 권한입니다. 이 보안 개체와 연결된 DACL은 OpCode가 wlan_intf_opcode_background_scan_enabled 설정된 WlanQueryInterface 또는 WlanSetInterface를 호출할 때 검색됩니다. WlanQueryInterface 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_READ_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다. WlanSetInterface 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_bss_type` 기본 서비스 집합 유형을 변경할 수 있는 권한입니다. 이 보안 개체와 연결된 DACL은 OpCode가 wlan_intf_opcode_bss_type 설정된 상태에서 WlanQueryInterface 또는 WlanSetInterface를 호출할 때 검색됩니다. WlanQueryInterface 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_READ_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다. WlanSetInterface 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_show_denied` 거부 목록의 네트워크가 사용 가능한 네트워크 목록에 표시되는지 여부를 수정하기 위한 권한입니다. 이 보안 개체와 연결된 DACL은 OpCode가 wlan_autoconf_opcode_show_denied_networks 설정된 상태에서 WlanQueryAutoConfigParameter 또는 WlanSetAutoConfigParameter를 호출할 때 검색됩니다. WlanQueryAutoConfigParameter 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_READ_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다. WlanSetAutoConfigParameter 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_interface_properties` 인터페이스 속성을 변경하기 위한 권한입니다. 다른 특정 보안 개체를 사용하지 않을 때 WlanQueryInterface 또는 WlanSetInterface 에서 사용하는 일반 보안 개체입니다. WlanQueryInterface 또는 WlanSetInterface가 호출 스레드의 액세스 토큰이고 OpCode가 wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled, wlan_intf_opcode_media_streaming_mode, wlan_intf_opcode_bss_type 또는wlan_intf_opcode_current_operation_mode 이외의 값으로 설정될 때마다 DACL이 검색됩니다. OpCode가 wlan_intf_opcode_radio_state 설정되고 호출자가 콘솔 사용자인 경우에도 DACL이 검색되지 않습니다. WlanQueryInterface 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_READ_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다. WlanSetInterface 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_ihv_control` WLAN 드라이버 또는 서비스의 IHV(독립 하드웨어 공급업체) 제어에 WlanIhvControl 함수를 사용할 수 있는 권한입니다. 이 보안 개체와 연결된 DACL은 WlanIhvControl 이 호출될 때 검색됩니다. 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_all_user_profiles_order` 모든 사용자 프로필의 순서를 수정하기 위한 권한입니다. 이 보안 개체와 연결된 DACL은 WlanSetProfileList 또는 WlanSetProfilePosition 이 프로필 목록에서 모든 사용자 프로필의 상대 순서를 변경하거나 모든 사용자 프로필을 프로필 목록의 하위 위치로 이동하는 작업을 수행하기 전에 검색됩니다. 두 호출 모두 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_add_new_all_user_profiles` 새 모든 사용자 프로필을 추가하기 위한 권한입니다. 참고 이 개체와 연결된 보안 설명자는 새로 만든 모든 사용자 프로필에 적용됩니다. 이 보안 개체와 연결된 DACL은 DwFlags가 0으로 설정된 WlanSetProfile을 호출할 때 검색됩니다. 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_add_new_per_user_profiles` 사용자별 새 프로필을 추가하기 위한 권한입니다. 이 보안 개체와 연결된 DACL은 WLAN_PROFILE_USER 설정된 dwFlags를 사용하여 WlanSetProfile이 호출될 때 검색됩니다. 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_media_streaming_mode_enabled` 미디어 스트리밍 모드를 설정하거나 쿼리할 수 있는 권한입니다. 이 보안 개체와 연결된 DACL은 OpCode가 wlan_intf_opcode_media_streaming_mode 설정된 상태에서 WlanQueryInterface 또는 WlanSetInterface를 호출할 때 검색됩니다. WlanQueryInterface 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_READ_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다. WlanSetInterface 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_current_operation_mode` 무선 인터페이스의 작업 모드를 설정하거나 쿼리할 수 있는 권한입니다. 이 보안 개체와 연결된 DACL은 OpCode가 wlan_intf_opcode_current_operation_mode 설정된 WlanQueryInterface 또는 WlanSetInterface를 호출할 때 검색됩니다. WlanQueryInterface 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_READ_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다. WlanSetInterface 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다.
`wlan_secure_get_plaintext_key` 무선 프로필에서 일반 텍스트 키를 검색할 수 있는 권한입니다. 이 보안 개체와 연결된 DACL은 입력 시 pdwFlags 매개 변수가 가리키는 값에 설정된 WLAN_PROFILE_GET_PLAINTEXT_KEY 플래그를 사용하여 WlanGetProfile 함수를 호출할 때 검색됩니다. WlanGetProfile 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_READ_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다. 기본적으로 일반 텍스트 키를 검색하는 권한은 로컬 컴퓨터의 Administrators 그룹 구성원에게만 허용됩니다. Windows 7: 이 값은 Windows 7 이상에서 추가된 네이티브 무선 API에 대한 확장입니다.
`wlan_secure_hosted_network_elevated_access` 권한 있는 호스트된 네트워크 함수를 호출하기 위한 액세스 권한이 상승된 권한입니다. 이 보안 개체와 연결된 DACL은 OpCode 매개 변수가 wlan_hosted_network_opcode_enable 설정된 WlanHostedNetworkSetProperty 함수를 호출할 때 검색됩니다. WlanHostedNetworkSetProperty 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다. 기본적으로 무선 호스트 네트워크 속성을 wlan_hosted_network_opcode_enable 설정할 수 있는 권한은 로컬 컴퓨터의 Administrators 그룹 구성원에게만 허용됩니다. 이 보안 개체와 연결된 DACL은 WlanHostedNetworkForceStart 함수가 호출될 때 검색됩니다. WlanHostedNetworkForceStart 호출이 성공하려면 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE가 포함되어야 합니다. 기본적으로 무선 호스트 네트워크를 강제로 시작할 수 있는 권한은 로컬 컴퓨터의 Administrators 그룹 구성원에게만 허용됩니다. Windows 7: 이 값은 Windows 7 이상에서 추가된 네이티브 무선 API에 대한 확장입니다.
`wlan_secure_virtual_station_extensibility` Windows 7: 이 값은 Windows 7 이상에서 추가된 네이티브 무선 API에 대한 확장입니다.
`wlan_secure_wfd_elevated_access` 이 값은 Wi-Fi Direct 서비스에서 내부적으로 사용하도록 예약되어 있습니다. Windows 8: 이 값은 Windows 8 이상에서 추가된 네이티브 무선 API에 대한 확장입니다.
`WLAN_SECURABLE_OBJECT_COUNT`

설명

이러한 개체는 WlanSetSecuritySettings를 사용하여 보호될 수 있습니다. 이러한 개체와 연결된 현재 권한은 WlanGetSecuritySettings를 사용하여 검색할 수 있습니다. 보안 개체 사용에 대한 자세한 내용은 DACLs가 개체 및 네이티브 Wifi API 권한 에 대한 액세스를 제어하는 방법을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	wlanapi.h