WlanSetInterface 함수(wlanapi.h)

아티클
08/28/2023

WlanSetInterface 함수는 지정된 인터페이스에 대한 사용자 구성 가능 매개 변수를 설정합니다.

구문

DWORD WlanSetInterface(
  [in] HANDLE           hClientHandle,
  [in] const GUID       *pInterfaceGuid,
  [in] WLAN_INTF_OPCODE OpCode,
  [in] DWORD            dwDataSize,
  [in] const PVOID      pData,
       PVOID            pReserved
);

매개 변수

[in] hClientHandle

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

[in] pInterfaceGuid

구성할 인터페이스의 GUID입니다.

[in] OpCode

설정할 매개 변수를 지정하는 WLAN_INTF_OPCODE 값입니다. 다음 표에서는 pData에서 매개 변수의 데이터 형식과 함께 유효한 상수를 나열합니다.

WLAN_INTF_OPCODE 값	pData 데이터 형식	Description
wlan_intf_opcode_autoconf_enabled	Bool	표시된 인터페이스에 대해 자동 구성을 사용하거나 사용하지 않도록 설정합니다.
wlan_intf_opcode_background_scan_enabled	Bool	표시된 인터페이스에 대한 백그라운드 검사를 사용하거나 사용하지 않도록 설정합니다.
wlan_intf_opcode_radio_state	WLAN_PHY_RADIO_STATE	인터페이스에 대한 특정 PHY(물리적 계층)의 소프트웨어 라디오 상태를 설정합니다.
wlan_intf_opcode_bss_type	DOT11_BSS_TYPE	BSS 형식을 설정합니다.
wlan_intf_opcode_media_streaming_mode	Bool	드라이버에 대한 미디어 스트리밍 모드를 설정합니다.
wlan_intf_opcode_current_operation_mode	ULONG	인터페이스의 현재 작업 모드를 설정합니다. 자세한 내용은 설명 부분을 참조하세요.

SP3이 있는 Windows XP 및 SP2를 사용하는 Windows XP용 무선 LAN API: wlan_intf_opcode_autoconf_enabled 및 wlan_intf_opcode_bss_type 상수만 유효합니다.

[in] dwDataSize

pData 매개 변수의 크기(바이트)입니다. dwDataSize가 pData에 할당된 실제 메모리 양보다 큰 경우 호출 프로그램에서 액세스 위반이 발생합니다.

[in] pData

OpCode 매개 변수에 지정된 대로 설정할 값입니다. pData가 가리키는 데이터 형식은 지정된 OpCode에 적합해야 합니다. 위의 표를 사용하여 사용할 데이터 형식을 결정합니다.

참고OpCode 가 wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled 또는 wlan_intf_opcode_media_streaming_mode 설정된 경우 pData 는 정수 값을 가리킬 수 있습니다. pData가 0을 가리키면 값이 FALSE로 변환됩니다. pData가 0이 아닌 정수로 가리키면 값이 TRUE로 변환됩니다.

pReserved

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

반환 값

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

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

설명

OpCode가 wlan_intf_opcode_current_operation_mode 설정되면 WlanSetInterface 함수는 무선 인터페이스의 현재 작업 모드를 설정합니다. 작업 모드에 대한 자세한 내용은 네이티브 802.11 작업 모드를 참조하세요. DOT11_OPERATION_MODE_EXTENSIBLE_STATION 및DOT11_OPERATION_MODE_NETWORK_MONITOR 두 가지 작업 모드가 지원됩니다. 작업 모드 상수는 헤더 파일 Windot11.h에 정의됩니다. OpCode가 wlan_intf_opcode_current_operation_mode 설정될 때 pData가 이러한 값 중 하나를 가리키지 않으면 WlanSetInterface 함수가 오류와 함께 실패합니다.

opCode가 wlan_intf_opcode_autoconf_enabled 설정된 WlanSetInterface를 호출하는 것과 기능적으로 동일한 명령줄에서 자동 구성 서비스를 사용하거나 사용하지 않도록 설정하려면 netsh wlan setautoconfig 명령을 사용합니다. 자세한 내용은 무선 로컬 영역 네트워크(wlan)에 대한 Netsh 명령을 참조하세요.

WlanSetInterface 함수를 호출하여 소프트웨어 라디오 상태를 변경할 수 있습니다. WlanSetInterface 함수를 호출하여 하드웨어 라디오 상태를 변경할 수 없습니다. OpCode 매개 변수가 wlan_intf_opcode_radio_state 설정되면 WlanSetInterface 함수는 특정 PHY의 소프트웨어 라디오 상태를 설정합니다. pData 매개 변수는 사용할 새 라디오 상태 값이 있는 WLAN_PHY_RADIO_STATE 구조를 가리킵니다. WLAN_PHY_RADIO_STATE 구조체의 dot11HardwareRadioState 멤버는 OpCode 매개 변수가 wlan_intf_opcode_radio_state 로 설정된 WlanSetInterface 함수를 호출하고 pData 매개 변수가 WLAN_PHY_RADIO_STATE 구조를 가리키는 경우 무시됩니다. 소프트웨어 라디오 상태(WLAN_PHY_RADIO_STATE 구조의 dot11SoftwareRadioState 멤버) 또는 하드웨어 라디오 상태(WLAN_PHY_RADIO_STATE구조의dot11HardwareRadioState 멤버)가 꺼져 있으면 PHY의 라디오 상태가 꺼집니다.

물리적 네트워크 인터페이스의 소프트웨어 라디오 상태를 변경하면 무선 호스티드 네트워크 또는 가상 무선 어댑터 라디오 상태의 상태가 관련 변경될 수 있습니다. 모든 가상 무선 어댑터의 PHY가 연결됩니다. 자세한 내용은 무선 호스트 네트워크 정보를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP3 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wlanapi.h(Wlanapi.h 포함)
라이브러리	Wlanapi.lib
DLL	Wlanapi.dll
재배포 가능 파일	SP2를 사용하는 Windows XP용 무선 LAN API