다음을 통해 공유

WlanSetAutoConfigParameter 함수(wlanapi.h)

  • 아티클

WlanSetAutoConfigParameter 함수는 자동 구성 서비스에 대한 매개 변수를 설정합니다.

구문

DWORD WlanSetAutoConfigParameter(
  [in] HANDLE               hClientHandle,
  [in] WLAN_AUTOCONF_OPCODE OpCode,
  [in] DWORD                dwDataSize,
  [in] const PVOID          pData,
       PVOID                pReserved
);

매개 변수

[in] hClientHandle

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

[in] OpCode

설정할 매개 변수를 지정하는 WLAN_AUTOCONF_OPCODE 값입니다. WLAN_AUTOCONF_OPCODE 열거형의 일부 opcode만 집합 작업을 지원합니다.

값 의미
wlan_autoconf_opcode_show_denied_networks
 설정되면 pData 매개 변수에 사용자 및 그룹 정책 거부 네트워크가 사용 가능한 네트워크 목록에 포함될지 여부를 나타내는 BOOL 값이 포함됩니다.
wlan_autoconf_opcode_allow_explicit_creds
 설정되면 pData 매개 변수에는 현재 무선 인터페이스에 공유 사용자 자격 증명이 허용되는지 여부를 나타내는 BOOL 값이 포함됩니다.
wlan_autoconf_opcode_block_period
 설정하면 pData 매개 변수에 현재 무선 인터페이스의 차단된 기간 설정에 대한 DWORD 값이 포함됩니다. 차단된 기간은 이전 오류 후 무선 네트워크에 대한 자동 연결을 시도하지 않는 시간(초)입니다.
wlan_autoconf_opcode_allow_virtual_station_extensibility
 설정하면 pData 매개 변수에 가상 스테이션의 확장성이 허용되는지 여부를 나타내는 BOOL 값이 포함됩니다. 기본적으로 가상 스테이션의 확장성이 허용됩니다. 이 opcode의 값은 다시 시작할 때 유지됩니다.

이 열거형 값은 무선 LAN 서비스가 설치된 Windows 7 및 Windows Server 2008 R2에서 지원됩니다.

[in] dwDataSize

pData 매개 변수의 크기(바이트)입니다. OpCode 매개 변수의 값에 따라 BOOL 또는 sizeof(DWORD) DWORD에 대해 이 매개 변수를 로 설정 sizeof(BOOL) 해야 합니다.

[in] pData

OpCode 매개 변수에 지정된 매개 변수에 대해 설정할 값입니다. pData 매개 변수는 OpCode 매개 변수의 값에 따라 부울 또는 DWORD 값을 가리킵니다. pData 매개 변수는 NULL이 아니어야 합니다.

참고pData 매개 변수는 부울이 필요한 경우 정수 값을 가리킬 수 있습니다. pData가 0을 가리키면 값이 FALSE로 변환됩니다. pData가 0이 아닌 정수로 가리키면 값이 TRUE로 변환됩니다.
 

pReserved

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

반환 값

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

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

반환 코드 설명
ERROR_ACCESS_DENIED
 액세스가 거부되었습니다. OpCode 매개 변수가 wlan_autoconf_opcode_show_denied_networks 또는 wlan_autoconf_opcode_allow_virtual_station_extensibility 때 호출자에게 구성 매개 변수를 설정할 수 있는 충분한 권한이 없는 경우 이 오류가 반환됩니다. OpCode 매개 변수가 이러한 값 중 하나로 설정되면 WlanSetAutoConfigParameter 함수는 opcode 개체에 대해 저장된 DACL(임의 액세스 제어 목록)을 검색합니다. DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE(액세스 제어 항목)가 포함되어 있지 않으면 WlanSetAutoConfigParameter 는 ERROR_ACCESS_DENIED 반환합니다.

구성 매개 변수가 도메인의 그룹 정책에 의해 설정된 경우에도 이 오류가 반환됩니다. opcode에 대해 그룹 정책을 설정하면 애플리케이션에서 변경할 수 없습니다. 다음 OpCode 매개 변수의 경우 그룹 정책에 의해 설정될 수 있습니다. wlan_autoconf_opcode_show_denied_networks, wlan_autoconf_opcode_allow_explicit_creds 및 wlan_autoconf_opcode_block_period
ERROR_INVALID_PARAMETER
 매개 변수가 잘못되었습니다. hClientHandle 매개 변수가 NULL이거나 pData 매개 변수가 NULL이거나 pReserved 매개 변수가 NULL이 아닌 경우 이 오류가 반환됩니다. 지정한 OpCode 매개 변수가 설정할 수 있는 구성 매개 변수에 대한 WLAN_AUTOCONF_OPCODE 값 중 하나가 아닌 경우에도 이 오류가 반환됩니다. dwDataSize 매개 변수가 로 설정sizeof(BOOL)되지 않았거나 OpCode 매개 변수 값에 따라 dwDataSize가 로 sizeof(BOOL) 설정되지 않은 경우에도 이 오류가 반환됩니다.
ERROR_INVALID_HANDLE
 핸들 테이블에서 hClientHandle 핸들을 찾을 수 없습니다.
ERROR_NOT_SUPPORTED
 이 함수는 지원되지 않는 플랫폼에서 호출되었습니다. SP3이 있는 Windows XP 또는 SP2 클라이언트를 사용하는 Windows XP용 무선 LAN API에서 이 함수가 호출된 경우 이 값이 반환됩니다.
RPC_STATUS
 다양한 오류 코드.

설명

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

OpCode 매개 변수의 값에 따라 pData가 가리키는 데이터는 자동 구성 매개 변수가 설정되기 전에 부울 값으로 변환됩니다. pData가 0을 가리키면 매개 변수가 FALSE로 설정됩니다. 그렇지 않으면 매개 변수가 TRUE로 설정됩니다.

요구 사항

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

추가 정보

WLAN_AUTOCONF_OPCODE

WlanQueryAutoConfigParameter