WLAN_CONNECTION_PARAMETERS 구조체(wlanapi.h)

WLAN_CONNECTION_PARAMETERS 구조체는 WlanConnect 함수를 사용할 때 사용되는 매개 변수를 지정합니다.

구문

typedef struct _WLAN_CONNECTION_PARAMETERS {
  WLAN_CONNECTION_MODE wlanConnectionMode;
#if ...
  LPCWSTR              strProfile;
#else
  LPCWSTR              strProfile;
#endif
  PDOT11_SSID          pDot11Ssid;
  PDOT11_BSSID_LIST    pDesiredBssidList;
  DOT11_BSS_TYPE       dot11BssType;
  DWORD                dwFlags;
} WLAN_CONNECTION_PARAMETERS, *PWLAN_CONNECTION_PARAMETERS;

멤버

wlanConnectionMode

연결 모드를 지정하는 WLAN_CONNECTION_MODE 값입니다.

WINDOWS XP SP3 및 Windows XP용 무선 LAN API SP2 사용: wlan_connection_mode_profile 값만 지원됩니다.

strProfile

연결에 사용되는 프로필을 지정합니다.

wlanConnectionMode가 wlan_connection_mode_profile 설정된 경우 strProfile은 연결에 사용되는 프로필의 이름을 지정합니다. wlanConnectionMode가 wlan_connection_mode_temporary_profile 설정된 경우 strProfile은 연결에 사용되는 프로필의 XML 표현을 지정합니다. wlanConnectionMode가 wlan_connection_mode_discovery_secure 또는 wlan_connection_mode_discovery_unsecure 설정된 경우 strProfile을 NULL로 설정해야 합니다.

WINDOWS XP SP3 및 Windows XP용 무선 LAN API SP2 사용: 프로필은 무선 프로필 호환성에 설명된 호환성 조건을 충족해야 합니다.

pDot11Ssid

연결할 네트워크의 SSID를 지정하는 DOT11_SSID 구조체에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다. NULL로 설정하면 프로필의 모든 SSID가 시도됩니다. WLAN_CONNECTION_MODE wlan_connection_mode_discovery_secure또는wlan_connection_mode_discovery_unsecure 설정된 경우 이 매개 변수는 NULL이 아니어야 합니다.

pDesiredBssidList

연결 에 필요한 BSS(기본 서비스 집합) 식별자 목록을 포함하는 DOT11_BSSID_LIST 구조체에 대한 포인터입니다.

WINDOWS XP SP3 및 Windows XP용 무선 LAN API SP2 사용: 이 멤버는 NULL이어야 합니다.

dot11BssType

네트워크의 BSS 유형을 나타내는 DOT11_BSS_TYPE 값입니다. 프로필이 제공된 경우 이 BSS 형식은 프로필의 형식과 동일해야 합니다.

dwFlags

다음 표에서는 연결 매개 변수를 지정하는 데 사용되는 플래그를 보여줍니다.

상수	값	Description
WLAN_CONNECTION_HIDDEN_NETWORK	0x00000001	대상이 숨겨진 네트워크인 경우에도 대상 네트워크에 연결합니다. 숨겨진 네트워크는 SSID를 브로드캐스트하지 않습니다. 대상 네트워크가 임시 네트워크인 경우 이 플래그를 사용하지 마세요. strProfile 에서 지정한 프로필이 NULL이 아닌 경우 이 플래그는 무시되고 nonBroadcast 프로필 요소는 숨겨진 네트워크에 연결할지 여부를 결정합니다.
WLAN_CONNECTION_ADHOC_JOIN_ONLY	0x00000002	임시 네트워크를 구성하지 마세요. 네트워크가 이미 있는 경우에만 임시 네트워크에 가입합니다. 대상 네트워크가 인프라 네트워크인 경우 이 플래그를 사용하지 마세요.
WLAN_CONNECTION_IGNORE_PRIVACY_BIT	0x00000004	네트워크에 연결할 때 개인 정보 비트를 무시합니다. 개인 정보 비트를 무시하면 패킷이 암호화되는지 여부를 무시하고 사용되는 암호화 방법을 무시하는 효과가 있습니다. 임시 프로필을 사용하여 인프라 네트워크에 연결할 때만 이 플래그를 사용합니다.
WLAN_CONNECTION_EAPOL_PASSTHROUGH	0x00000008	암호화 및 암호 해독에서 EAPOL 트래픽을 제외합니다. 이 플래그는 애플리케이션이 Open 인증 및 WEP 암호화를 사용하는 인프라 네트워크를 통해 EAPOL 트래픽을 보내야 하는 경우에 사용됩니다. 이 플래그는 802.1X 인증이 필요한 네트워크에 연결하는 데 사용하면 안 됩니다. 이 플래그는 wlanConnectionMode 가 wlan_connection_mode_temporary_profile 설정된 경우에만 유효합니다. 가능하면 이 플래그를 사용하지 마세요.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE	0x00000010	연결 완료에 성공하면 검색 프로필을 자동으로 유지합니다. 이 플래그는 wlan_connection_mode_discovery_secure 또는 wlan_connection_mode_discovery_unsecure 경우에만 유효합니다. 프로필은 WlanUtf8SsidToDisplayName을 사용하여 SSID에서 생성된 이름으로 모든 사용자 프로필로 저장됩니다. 이름이 같은 프로필이 이미 있는 경우 프로필 이름의 끝에 숫자가 추가됩니다. WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO 지정하지 않는 한 프로필은 수동 연결 모드로 저장됩니다.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO	0x00000020	WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE 함께 사용할 수 있습니다. 검색 프로필은 자동 연결 모드로 유지됩니다.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_OVERWRITE_EXISTING	0x00000040	WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE 함께 사용할 수 있습니다. 검색 프로필이 유지되고 동일한 이름의 기존 프로필을 덮어쓰려고 시도합니다.

 

WINDOWS XP SP3 및 Windows XP용 무선 LAN API SP2 사용: 이 멤버는 0으로 설정해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP3 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	wlanapi.h
재배포 가능 파일	WINDOWS XP용 무선 LAN API SP2

추가 정보

WlanConnect