WlanSetInterface 함수(wlanapi.h)
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에 적합해야 합니다. 위의 표를 사용하여 사용할 데이터 형식을 결정합니다.
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 |