WLAN_BSS_ENTRY 구조체(wlanapi.h)
WLAN_BSS_ENTRY 구조에는 BSS(기본 서비스 집합)에 대한 정보가 포함되어 있습니다.
구문
typedef struct _WLAN_BSS_ENTRY {
DOT11_SSID dot11Ssid;
ULONG uPhyId;
DOT11_MAC_ADDRESS dot11Bssid;
DOT11_BSS_TYPE dot11BssType;
DOT11_PHY_TYPE dot11BssPhyType;
LONG lRssi;
ULONG uLinkQuality;
BOOLEAN bInRegDomain;
USHORT usBeaconPeriod;
ULONGLONG ullTimestamp;
ULONGLONG ullHostTimestamp;
USHORT usCapabilityInformation;
ULONG ulChCenterFrequency;
WLAN_RATE_SET wlanRateSet;
ULONG ulIeOffset;
ULONG ulIeSize;
} WLAN_BSS_ENTRY, *PWLAN_BSS_ENTRY;
멤버
dot11Ssid
BSS와 연결된 AP(액세스 지점) 또는 피어 스테이션의 SSID입니다. 이 멤버의 데이터 형식은 DOT11_SSID 구조입니다.
uPhyId
무선 LAN 인터페이스가 BSS 네트워크를 검색하는 데 사용한 PHY의 식별자(ID)입니다.
dot11Bssid
스캔하는 동안 무선 LAN 인터페이스에서 수신한 802.11 비콘 또는 프로브 응답 프레임을 전송한 독립 BSS 네트워크(임시 네트워크)용 인프라 BSS 네트워크 또는 피어 스테이션에 대한 액세스 지점의 MAC(미디어 액세스 제어) 주소입니다. 이 멤버의 데이터 형식은 DOT11_MAC_ADDRESS 구조입니다.
dot11BssType
BSS 네트워크 유형입니다. 이 멤버의 데이터 형식은 DOT11_BSS_TYPE 열거형 값입니다.
이 멤버는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
인프라 BSS 네트워크를 지정합니다. |
|
IBSS(독립 BSS) 네트워크(임시 네트워크)를 지정합니다. |
dot11BssPhyType
이 네트워크의 PHY 유형입니다. 이 멤버의 데이터 형식은 DOT11_PHY_TYPE 열거형 값입니다.
lRssi
AP 또는 피어 스테이션의 무선 LAN 인터페이스 드라이버에서 감지한 대로 수신된 RSSI(신호 강도 표시기) 값(1.0밀리와트(dBm)에 참조되는 데시벨 단위입니다.
uLinkQuality
무선 LAN 인터페이스 드라이버에서 보고한 링크 품질입니다. 링크 품질 값의 범위는 0에서 100까지입니다. 값 100은 가장 높은 링크 품질을 지정합니다.
bInRegDomain
AP 또는 피어 스테이션이 국가/지역에서 식별된 대로 규정 도메인 내에서 작동하고 있는지 여부를 지정하는 값입니다.
무선 LAN 인터페이스 드라이버가 여러 규제 도메인을 지원하지 않는 경우 이 멤버는 TRUE로 설정됩니다.
AP 또는 피어 스테이션에서 받은 802.11 비콘 또는 프로브 응답 프레임에 IE(국가 정보 요소)가 포함되지 않은 경우 이 멤버는 TRUE로 설정됩니다.
AP 또는 피어 스테이션에서 받은 802.11 비콘 또는 프로브 응답 프레임에 Country IE가 포함된 경우 Country String 하위 필드의 값이 입력 국가 문자열과 같지 않으면 이 멤버는 FALSE 로 설정됩니다.
usBeaconPeriod
무선 LAN 인터페이스에서 수신한 802.11 비콘 또는 프로브 응답 프레임의 비콘 간격 필드 값입니다.
간격은 대상 비콘 전송 시간 사이의 1,024 마이크로초 시간 단위입니다. 이 정보는 프로브 요청을 보내는 무선 LAN 클라이언트에 대한 응답으로 인프라 BSS 네트워크의 액세스 지점 또는 액세스 지점 또는 피어 스테이션에서 프로브 응답에서 보낸 비콘 패킷에서 검색됩니다.
IEEE 802.11 표준은 시간 단위를 1,024 마이크로초와 동일하게 정의합니다. 이 단원은 하드웨어에서 쉽게 구현할 수 있도록 정의되었습니다.
ullTimestamp
무선 LAN 인터페이스에서 수신한 802.11 비콘 또는 프로브 응답 프레임의 타임스탬프 필드 값입니다.
ullHostTimestamp
무선 LAN 인터페이스가 비콘 또는 프로브 응답 프레임을 수신했을 때 기록하는 호스트 타임스탬프 값입니다. 이 멤버는 1601년 1월 1일 이후 100나노초 간격의 수입니다.
자세한 내용은 WDK에 설명된 NdisGetCurrentSystemTime 함수를 참조하세요.
usCapabilityInformation
무선 LAN 인터페이스에서 수신한 802.11 비콘 또는 프로브 응답 프레임의 기능 정보 필드 값입니다. 이 값은 기능을 정의하는 비트 플래그 집합입니다.
이 멤버는 다음 값 중 하나 이상일 수 있습니다.
ulChCenterFrequency
802.11 비콘 또는 프로브 응답 프레임이 수신된 대역의 채널 중심 주파수입니다. ulChCenterFrequency 값은 kHz(킬로헤르츠) 단위입니다.
wlanRateSet
BSS에서 지원하는 데이터 전송 속도 집합입니다. 이 멤버의 데이터 형식은 WLAN_RATE_SET 구조체입니다.
ulIeOffset
WLAN_BSS_ENTRY 구조의 시작 부분에서 IE(정보 요소) 데이터 Blob의 오프셋(바이트)입니다.
이 멤버는 802.11 비콘 또는 프로브 응답 프레임의 가변 길이 정보 요소(ES)가 포함된 버퍼를 가리킵니다. 각 BSS에 대해 ES는 해당 BSS 네트워크에서 받은 마지막 비콘 또는 프로브 응답 프레임에서 가져옵니다. 한 프레임에서만 IE를 사용할 수 있는 경우 무선 LAN 인터페이스 드라이버는 마지막으로 수신한 비콘 또는 프로브 응답 프레임의 다른 IE와 IE를 병합합니다.
정보 요소는 IEEE 802.11 사양에 정의되어 1바이트 요소 ID 필드, 1바이트 길이 필드 및 가변 길이 요소 관련 정보 필드로 구성된 일반적인 형식을 갖습니다. 각 정보 요소에는 이 IEEE 802.11 표준에 정의된 고유한 요소 ID 값이 할당됩니다. 길이 필드는 정보 필드의 바이트 수를 지정합니다.
ulIeSize
WLAN_BSS_ENTRY 구조에서 IE 데이터 Blob의 크기(바이트)입니다.
이는 ulIeOffset 멤버가 가리키는 버퍼에 있는 데이터의 정확한 길이이며 맞춤을 위한 패딩을 포함하지 않습니다. IE 데이터 Blob 크기의 최대값은 2,324바이트입니다.
설명
WlanGetNetworkBssList 함수는 지정된 인터페이스에서 무선 네트워크 또는 네트워크의 BSS 목록을 검색하고 배열이 포함된 WLAN_BSS_LIST 구조에서 이 정보를 반환합니다. WLAN_BSS_ENTRY 구조체입니다.
무선 LAN 인터페이스가 무선 호스트 네트워크로도 작동하는 경우 BSS 목록에는 무선 호스트 네트워크에 대해 만든 BSS에 대한 항목이 포함됩니다.
정보는 인프라 BSS 네트워크의 액세스 지점 또는 독립적인 BSS 네트워크(임시 네트워크)에 대한 네트워크 피어에서 반환되므로 반환된 정보를 신뢰할 수 없습니다. WLAN_BSS_ENTRY 구조의 ulIeOffset 및 ulIeSize 멤버를 사용하여 정보 요소 데이터 Blob의 데이터가 아니라 WLAN_BSS_ENTRY 구조에서 정보 요소 데이터 Blob의 최대 크기를 결정해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | wlanapi.h |