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 형식만 포함됩니다.
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
네트워크에 대한 다양한 플래그를 포함합니다.
| 값 | 의미 |
|---|---|
|
이 네트워크는 현재 연결되어 있습니다. |
|
이 네트워크에 대한 프로필이 있습니다. |
dwReserved
다음에 사용하도록 예약됩니다. NULL로 설정해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP3 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | wlanapi.h |
| 재배포 가능 파일 | WINDOWS XP용 무선 LAN API SP2 |