WlanGetFilterList 함수(wlanapi.h)

WlanGetFilterList 함수는 그룹 정책 또는 사용자 권한 목록을 검색합니다.

구문

DWORD WlanGetFilterList(
  [in]  HANDLE                hClientHandle,
  [in]  WLAN_FILTER_LIST_TYPE wlanFilterListType,
        PVOID                 pReserved,
  [out] PDOT11_NETWORK_LIST   *ppNetworkList
);

매개 변수

[in] hClientHandle

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

[in] wlanFilterListType

필터 목록의 형식을 지정하는 WLAN_FILTER_LIST_TYPE 값입니다. 모든 사용자 정의 및 그룹 정책 필터 목록을 쿼리할 수 있습니다.

pReserved

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

[out] ppNetworkList

허용되거나 거부된 네트워크 목록을 포함하는 DOT11_NETWORK_LIST 구조체에 대한 포인터입니다.

반환 값

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

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

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

설명

WlanSetFilterList를 호출하여 사용자 권한 목록을 설정할 수 있습니다.

요구 사항

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

추가 정보

DOT11_NETWORK_LIST

WLAN_FILTER_LIST_TYPE

WlanSetFilterList