다음을 통해 공유

WlanSetFilterList 함수(wlanapi.h)

  • 아티클

WlanSetFilterList 함수는 허용/거부 목록을 설정합니다.

구문

DWORD WlanSetFilterList(
  [in]           HANDLE                    hClientHandle,
  [in]           WLAN_FILTER_LIST_TYPE     wlanFilterListType,
  [in, optional] const PDOT11_NETWORK_LIST pNetworkList,
                 PVOID                     pReserved
);

매개 변수

[in] hClientHandle

WlanOpenHandle 함수에 대한 이전 호출에서 얻은 클라이언트의 세션 핸들입니다.

[in] wlanFilterListType

필터 목록의 형식을 지정하는 WLAN_FILTER_LIST_TYPE 값입니다. 값은 wlan_filter_list_type_user_permit 또는 wlan_filter_list_type_user_deny 합니다. 이 함수를 사용하여 그룹 정책 정의 목록을 설정할 수 없습니다.

[in, optional] pNetworkList

허용하거나 거부할 네트워크 목록이 포함된 DOT11_NETWORK_LIST 구조체에 대한 포인터입니다. 구조체의 dwIndex 멤버에는 구조체의 dwNumberOfItems 멤버 값보다 작은 값이 있어야 합니다. 그렇지 않으면 액세스 위반이 발생할 수 있습니다.

pReserved

다음에 사용하도록 예약됩니다. NULL로 설정해야 합니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 다음 반환 코드 중 하나일 수 있습니다.

반환 코드 설명
ERROR_ACCESS_DENIED
 호출자에게 필터 목록을 설정할 수 있는 충분한 권한이 없습니다.

wlanFilterListType이 wlan_filter_list_type_user_permit 설정된 상태에서 호출되면 WlanSetFilterList는 wlan_secure_permit_list 개체와 함께 저장된 DACL(임의 액세스 제어 목록)을 검색합니다. wlanFilterListType이 wlan_filter_list_type_user_deny 설정된 상태에서 호출되면 WlanSetFilterList는 wlan_secure_deny_list 개체와 함께 저장된 DACL을 검색합니다. 이러한 경우 중 하나에서 DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE(액세스 제어 항목)가 없는 경우 WlanSetFilterList 는 ERROR_ACCESS_DENIED 반환합니다.
ERROR_INVALID_PARAMETER
 hClientHandle 이 NULL 이거나 잘못되었거나 pReserved 가 NULL이 아닙니다.
ERROR_INVALID_HANDLE
 핸들 테이블에 hClientHandle 핸들을 찾을 수 없습니다.
ERROR_NOT_SUPPORTED
 이 함수는 지원되지 않는 플랫폼에서 호출되었습니다. SP3이 있는 Windows XP 또는 SP2 클라이언트가 있는 Windows XP용 무선 LAN API에서 이 함수를 호출한 경우 이 값이 반환됩니다.
RPC_STATUS
 다양한 오류 코드.

설명

그룹 정책 허용 및 거부 목록이 사용자의 허용 및 거부 목록보다 우선합니다. 즉, 네트워크가 그룹 정책 거부 목록에 표시되면 사용자의 허용 목록에 있는 네트워크에 대한 액세스가 거부됩니다. 마찬가지로, 네트워크가 그룹 정책 허용 목록에 표시되는 경우 사용자의 거부 목록에 있는 네트워크에 대한 액세스가 허용됩니다. 사용자 목록 또는 그룹 정책 목록에 없는 네트워크는 허용됩니다.

거부된 네트워크는 자동 구성을 통해 연결할 수 없으며 표시되는 네트워크 목록에 포함되지 않습니다. 새 사용자 허용 및 거부 목록은 이전 버전의 사용자 목록을 덮어씁니다.

필터 목록을 지우려면 pNetworkList 매개 변수를 NULL로 설정하거나 dwNumberOfItems 멤버가 0으로 설정된 DOT11_NETWORK_LIST 구조체에 포인터를 전달합니다.

필터 목록에 모든 SSID를 추가하려면 DOT11_SSID 구조체의 uSSIDLength 멤버가 0으로 설정된 연결된 DOT11_NETWORK 구조체가 있는 DOT11_NETWORK_LIST 구조체에 포인터를 전달합니다.

필터 목록에 모든 BSS 형식을 추가하려면 dot11BssType 멤버가 dot11_BSS_type_any 설정된 연결된 DOT11_NETWORK 구조체가 있는 DOT11_NETWORK_LIST 포인터를 전달합니다.

netsh wlan add filter 및 netsh wlan delete 필터 명령은 명령줄에서 유사한 기능을 제공합니다. 자세한 내용은 무선 로컬 영역 네트워크(wlan)에 대한 Netsh 명령을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 wlanapi.h(Wlanapi.h 포함)
라이브러리 Wlanapi.lib
DLL Wlanapi.dll

추가 정보

WlanGetFilterList