다음을 통해 공유

WLAN_AVAILABLE_NETWORK 구조체(wlanapi.h)

  • 아티클

WLAN_AVAILABLE_NETWORK 구조에는 사용 가능한 무선 네트워크에 대한 정보가 포함되어 있습니다.

구문

typedef struct _WLAN_AVAILABLE_NETWORK {
  WCHAR                  strProfileName[WLAN_MAX_NAME_LENGTH];
  DOT11_SSID             dot11Ssid;
  DOT11_BSS_TYPE         dot11BssType;
  ULONG                  uNumberOfBssids;
  BOOL                   bNetworkConnectable;
  WLAN_REASON_CODE       wlanNotConnectableReason;
  ULONG                  uNumberOfPhyTypes;
  DOT11_PHY_TYPE         dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER];
  BOOL                   bMorePhyTypes;
  WLAN_SIGNAL_QUALITY    wlanSignalQuality;
  BOOL                   bSecurityEnabled;
  DOT11_AUTH_ALGORITHM   dot11DefaultAuthAlgorithm;
  DOT11_CIPHER_ALGORITHM dot11DefaultCipherAlgorithm;
  DWORD                  dwFlags;
  DWORD                  dwReserved;
} WLAN_AVAILABLE_NETWORK, *PWLAN_AVAILABLE_NETWORK;

멤버

strProfileName[WLAN_MAX_NAME_LENGTH]

네트워크와 연결된 프로필 이름을 포함합니다. 네트워크에 프로필이 없으면 이 멤버는 비어 있습니다. 여러 프로필이 네트워크와 연결된 경우 표시되는 네트워크 목록에 동일한 SSID를 가진 여러 항목이 있습니다. 프로필 이름은 대/소문자를 구분합니다. 이 문자열은 NULL로 종료되어야 합니다.

dot11Ssid

표시되는 무선 네트워크의 SSID를 포함하는 DOT11_SSID 구조체입니다.

dot11BssType

네트워크가 인프라인지 임시인지를 지정하는 DOT11_BSS_TYPE 값입니다.

uNumberOfBssids

네트워크의 BSSID 수를 나타냅니다.

SP2를 사용하는 Windows XP용 SP3 및 무선 LAN API가 있는 Windows XP: uNumberofBssids 는 SSID를 브로드캐스트하는 액세스 지점 수에 관계없이 최대 1개입니다.

bNetworkConnectable

네트워크를 연결할 수 있는지 여부를 나타냅니다. TRUE로 설정하면 네트워크를 연결할 수 있고, 그렇지 않으면 네트워크를 연결할 수 없습니다.

wlanNotConnectableReason

네트워크를 연결할 수 없는 이유를 나타내는 WLAN_REASON_CODE 값입니다. 이 멤버는 bNetworkConnectable 이 FALSE인 경우에만 유효합니다.

uNumberOfPhyTypes

사용 가능한 네트워크에서 지원되는 PHY 유형의 수입니다. uNumberOfPhyTypes의 최대값은 값이 8인 WLAN_MAX_PHY_TYPE_NUMBER. WLAN_MAX_PHY_TYPE_NUMBER 이상의 PHY 형식이 지원되는 경우 bMorePhyTypes를TRUE로 설정해야 합니다.

dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER]

사용 가능한 네트워크에서 지원하는 PHY 형식을 나타내는 DOT11_PHY_TYPE 값의 배열을 포함합니다. uNumberOfPhyTypes가 WLAN_MAX_PHY_TYPE_NUMBER보다 큰 경우 이 배열에는 첫 번째 WLAN_MAX_PHY_TYPE_NUMBER PHY 형식만 포함됩니다.

값 의미
dot11_phy_type_unknown
 알 수 없거나 초기화되지 않은 PHY 형식을 지정합니다.
dot11_phy_type_any
 PHY 형식을 지정합니다.
dot11_phy_type_fhss
 FHSS(주파수 호핑 확산 스펙트럼) PHY를 지정합니다. Bluetooth 디바이스는 FHSS 또는 FHSS 적응을 사용할 수 있습니다.
dot11_phy_type_dsss
 DSSS(직접 시퀀스 확산 스펙트럼) PHY를 지정합니다.
dot11_phy_type_irbaseband
 IR(적외선) 베이스밴드 PHY를 지정합니다.
dot11_phy_type_ofdm
 OFDM(직교 주파수 나누기 멀티플렉싱) PHY를 지정합니다. 802.11a 디바이스는 OFDM을 사용할 수 있습니다.
dot11_phy_type_hrdsss
 높은 비율의 DSSS(HRDSS) PHY를 지정합니다.
dot11_phy_type_erp
 ERP(확장 속도 PHY)를 지정합니다. 802.11g 디바이스는 ERP를 사용할 수 있습니다.
dot11_phy_type_ht
 802.11n PHY 형식을 지정합니다.
dot11_phy_type_vht
 802.11ac PHY 형식을 지정합니다. 이는 IEEE 802.11ac에 지정된 매우 높은 처리량 PHY 유형입니다.

이 값은 Windows 8.1, Windows Server 2012 R2 이상에서 지원됩니다.
dot11_phy_type_IHV_start
 IHV(독립 하드웨어 공급업체)에서 개발한 PHY 형식을 정의하는 데 사용되는 범위의 시작을 지정합니다.
dot11_phy_type_IHV_end
 IHV(독립 하드웨어 공급업체)에서 개발한 PHY 형식을 정의하는 데 사용되는 범위의 끝을 지정합니다.

bMorePhyTypes

지원되는 PHY 유형이 WLAN_MAX_PHY_TYPE_NUMBER 이상인지를 지정합니다.

이 멤버를 TRUE로 설정하면 애플리케이션에서 WlanGetNetworkBssList 를 호출하여 PHY 형식의 전체 목록을 가져와야 합니다. 반환된 WLAN_BSS_LIST 구조체에는 WLAN_BSS_ENTRY 구조체의 배열이 있습니다. WLAN_BSS_ENTRY 구조체의 uPhyId 멤버는 항목에 대한 PHY 형식을 포함합니다.

wlanSignalQuality

네트워크의 신호 품질을 나타내는 백분율 값입니다. WLAN_SIGNAL_QUALITYULONG 형식입니다. 이 멤버는 0에서 100 사이의 값을 포함합니다. 값이 0이면 실제 RSSI 신호 강도가 -100 dbm인 것을 의미합니다. 값이 100이면 실제 RSSI 신호 강도가 -50dbm인 것을 의미합니다. 선형 보간을 사용하여 1에서 99 사이의 wlanSignalQuality 값에 대한 RSSI 신호 강도 값을 계산할 수 있습니다.

bSecurityEnabled

네트워크에서 보안을 사용할 수 있는지 여부를 나타냅니다. TRUE 값은 보안이 사용됨을 나타내고, 그렇지 않으면 사용하지 않음을 나타냅니다.

dot11DefaultAuthAlgorithm

이 네트워크를 처음으로 조인하는 데 사용되는 기본 인증 알고리즘을 나타내는 DOT11_AUTH_ALGORITHM 값입니다.

dot11DefaultCipherAlgorithm

이 네트워크에 조인할 때 사용할 기본 암호 알고리즘을 나타내는 DOT11_CIPHER_ALGORITHM 값입니다.

dwFlags

네트워크에 대한 다양한 플래그를 포함합니다.

값 의미
WLAN_AVAILABLE_NETWORK_CONNECTED
 이 네트워크는 현재 연결되어 있습니다.
WLAN_AVAILABLE_NETWORK_HAS_PROFILE
 이 네트워크에 대한 프로필이 있습니다.

dwReserved

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

요구 사항

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

추가 정보

WLAN_AVAILABLE_NETWORK_LIST