다음을 통해 공유

WlanQueryAutoConfigParameter 함수(wlanapi.h)

  • 아티클

WlanQueryAutoConfigParameter 함수는 자동 구성 서비스의 매개 변수를 쿼리합니다.

구문

DWORD WlanQueryAutoConfigParameter(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_AUTOCONF_OPCODE    OpCode,
                  PVOID                   pReserved,
  [out]           PDWORD                  pdwDataSize,
  [out]           PVOID                   *ppData,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pWlanOpcodeValueType
);

매개 변수

[in] hClientHandle

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

[in] OpCode

쿼리할 구성 매개 변수를 지정하는 값입니다.

값 의미
wlan_autoconf_opcode_show_denied_networks
 설정되면 ppData 매개 변수에 사용자 및 그룹 정책 거부 네트워크가 사용 가능한 네트워크 목록에 포함될지 여부를 나타내는 BOOL 값이 포함됩니다.

함수가 ERROR_SUCCESS 반환하고 ppData 가 TRUE를 가리키면 사용자 및 그룹 정책 거부 네트워크가 사용 가능한 네트워크 목록에 포함됩니다. FALSE이면 사용자 및 그룹 정책 거부 네트워크가 사용 가능한 네트워크 목록에 포함되지 않습니다.
wlan_autoconf_opcode_power_setting
 설정되면 ppData 매개 변수에는 전원 설정을 지정하는 WLAN_POWER_SETTING 값이 포함됩니다.
wlan_autoconf_opcode_only_use_gp_profiles_for_allowed_networks
 설정되면 ppData 매개 변수에는 그룹 정책으로 생성되지 않은 프로필을 일치하는 그룹 정책 프로필로 허용된 네트워크에 연결하는 데 사용할 수 있는지 여부를 나타내는 BOOL 값이 포함됩니다.

함수가 ERROR_SUCCESS 반환하고 ppData 가 TRUE를 가리키는 경우 그룹 정책에서 만든 프로필만 사용할 수 있습니다. FALSE이면 모든 프로필을 사용할 수 있습니다.
wlan_autoconf_opcode_allow_explicit_creds
 설정되면 ppData 매개 변수에는 현재 무선 인터페이스에 공유 사용자 자격 증명이 허용되는지 여부를 나타내는 BOOL 값이 포함됩니다.

함수가 ERROR_SUCCESS 반환하고 ppData 가 TRUE를 가리키는 경우 현재 무선 인터페이스에 공유 사용자 자격 증명이 허용됩니다. FALSE이면 현재 무선 인터페이스에서 공유 사용자 자격 증명을 허용하지 않습니다.
wlan_autoconf_opcode_block_period
 설정되면 ppData 매개 변수에 현재 무선 인터페이스의 차단된 기간 설정을 나타내는 DWORD 값이 포함됩니다. 차단된 기간은 이전 오류 후 무선 네트워크에 대한 자동 연결을 시도하지 않는 시간(초)입니다.
wlan_autoconf_opcode_allow_virtual_station_extensibility
 설정되면 ppData 매개 변수에 가상 스테이션의 확장성이 허용되는지 여부를 나타내는 BOOL 값이 포함됩니다. 기본적으로 가상 스테이션의 확장성이 허용됩니다. 이 opcode의 값은 다시 시작할 때 유지됩니다.

함수가 ERROR_SUCCESS 반환하고 ppData 가 TRUE를 가리키면 가상 스테이션에서 확장이 허용됩니다. FALSE이면 가상 스테이션에서 확장이 허용되지 않습니다.

pReserved

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

[out] pdwDataSize

ppData 매개 변수의 크기를 바이트 단위로 지정합니다.

[out] ppData

OpCode에 지정된 매개 변수에 대해 쿼리된 값을 포함하는 메모리에 대한 포인터입니다.

참고OpCode 가 wlan_autoconf_opcode_show_denied_networks 설정된 경우 ppData 에서 참조하는 포인터가 정수 값을 가리킬 수 있습니다. ppData에서 참조하는 포인터가 0을 가리키는 경우 정수 값은 부울 값 FALSE로 변환되어야 합니다. ppData에서 참조하는 포인터가 0이 아닌 정수 를 가리키는 경우 정수 값은 부울 값 TRUE로 변환되어야 합니다.
 

[out, optional] pWlanOpcodeValueType

WLAN_OPCODE_VALUE_TYPE 값입니다.

반환 값

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

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

반환 코드 설명
ERROR_ACCESS_DENIED
 호출자에게 구성 매개 변수를 가져올 수 있는 충분한 권한이 없습니다.

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

설명

WlanQueryAutoConfigParameter 함수는 Windows Vista 이상에서 지원되는 무선 구성 구성 요소인 ACM(자동 구성 모듈)에서 사용하는 매개 변수를 쿼리합니다.

요구 사항

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

추가 정보

WLAN_AUTOCONF_OPCODE

WlanSetAutoConfigParameter